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The first machine Known to have been 
invented on planet Earth with the ability to 
contain a stored and modifiable program to control 
its operation was invented in 1801 by the French 
silkweavert Joseph-Marie Charles Jacquard. It 
was Known as the Jacquard loom and its programs 
were encoded as a series of punched holes on paper 
cardSf the dominant means of program storage for 
the next 170 years. The invention enabled the 
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had its beginnings with the loom that could be 
programmed. French silK is to this day the finest, 
smoothest, most carefully crafted of fabrics. 
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In±roduci:ion 

This book has been written both as a general purpose Commodore 
64 and 6516 microprocessor tutorial and as a speci-fic complement to 
and guide "for the use o-f a set of software tools. The tools* along 
with this book comprise Develop-64t a product of French Silk. While 
this book is certainly a useful tool in its own right* its value may 
be magnified considerably when used in con^nction with the other 
tools. Programmers of all levels of experience should find this guide 
a valuable resource. 

The book may basically be divided into three sections. The 
first section provides information on the use of the Develop-64> the 
software. It brings you step-by-step through the mechanics of 
creating* modifying* running and debugging machine language programs. 

The second section gives a detailed look at the architecture 
of the 6510 microprocessor. Its addressing modes* register set and 
instruction set are examined. The nature and structure of data is 
also explored. The introduction to assembly language is presented in 
this section. 

The third section is very Commodore 64-specific. It provides 
the information which is necessary to utilize the Commodore 64's 
built-in programs. It provides memory maps of all of the 64's BASIC 
operating system along with the information as to how to use some of 
the built-in programs. It describes how to build custom characters* 
create sprites and how to produce bit-image graphics and to program 
the music synthesiser. 

The appendixes contain additional information on the 6510 and 
the Commodore 64 along with some useful tables and sample progams. 
Also included is a tutorial on binary and hexadecimal number bases. 

It is specifically prohibited to make copies of the software or 
this book for resale or for distribution to friends, relatives* 
associates or anyone else. We hope you will respect the legal and 
ethical restrictions which apply to the theft of software* both ours 
and everyone else's. 
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While this product provides tools which may facilitate the r\ 
copying o-f legally protected software » it is not the intent of French 
Silk that you put these tools to this use. We oppose and wish to very O 
strongly discourage the pirating of software. We would also like to ^ 
point out that there are severe penalties associated with copyright 
violation including fines up to and imprisonment of up to one ^ 

year (not to mention civil liability). We remind you that programmers 
have the same sort of financial obligations as everyone else and when O 
you make a copy of a software product to give to a friend you are 
committing an act of theft against the programmer. In the interest of O 
promoting the continued development of high-quality and low-cost ^ 
software » the consumer must play his and her roles in helping to 
eliminate this problem. r) 

Thank you for your cooperation and may all your programs work 
the first time. Enjoy Develop-64. O 
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Using Develop— 64 — I 

This chapter will provide an overview of the software tools 
which comprise Develop-64. It also will lead you through the first 
steps of the use of the tools. It is recommended you go through the 
exercise of entering* modifying, assembling* etc. the given programs 
in the text as you read. The sample program created in this chapter 
will be used in subsequent chapters to illustrate the use of other 
functions and capabilities of Develop-64. It is not necessary to 
understand the program you enter at this time. It will be explained 
in more detail later. This and the next few chapters are designed to 
familiarize you with the mechanics of operating Develop-64. Very 
detailed explanation of machine language, the architecture of the 6519 
and the Commodore 64 will be presented in subsequent chapters. You 
may find it valuable to return to these first chapters after you have 
gained more understanding. 



Overview 

To get started you should have the 64 turned on and the tape 
or diskette in the appropriate device ready to load. Load Develop-64 
much as you would load any other program, i.e. LOAD "DEVELOP-64" ,8 for 
disk or LOAD "DEVELOP-64" for tape. If you experience trouble loading 
Develop-64 be sure you have spelled the name right and that all of 
your equipment is in proper working condition. If LOAD ERRORs prevent 
you from loading the program or the program ^st doesn't seem to be 
on the media at all and you are sure your machines are in good working 
order, you should return the media for replacement. 

Start the program in the usual fashion, i.e. by typing "RUN" 
followed by CR3 (the symbol used in this book to signify the return 
key). Please note that we use the quotes (") frequently in this book 
to bracket the response you are instructed to give to various prompts. 
The quotes are not a part of what you key into the computer. Key only 
what is enclosed within them. 

The first question you will be asked relates to where in the 
memory space of the 64 you would like Develop-64 to reside. The 
default values if you hit CR] will be from $9860 to $BFFF (2048 to 
49959). It may be placed anywhere there is 16k available. The 
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reasons -for wanting to determine the starting and ending addresses 
will be discussed later. For now hit CR] twice. 

The message which is now displayed is: 

THE MAXIMUM NUMBER OF STATEMENTS YOU MAY HAVE IN A SOURCE 
SEGMENT IS NOW .... 

The value printed is computed -from the starting and ending 
addresses given above. Now the screen will get strange ior awhile and 
then the copyright message will appear followed by the main menu as 
described below. After the menu will be a question mark (?). 

The main menu 

When Develop-64 is initially run and upon exiting from any of 
the sub-programs the main menu of possible sub-programs is displayed: 

1) EXIT 2) EDIT 3) ASSEM 4) DECODE 
5) DEBUG 6) LOAD 7> SAUE 8> NEW 

Option 1 of the main menu causes the return to BASIC. Every 
sub-program also has number 1 as the exit option. For the sub- 
programs this option causes a return to the main menu. 

Option 2 causes the editor sub-program to be run. The editor 
is used to create assembly language programs from scratch or to make 
modifications to them. With it you can insert* delete* modify and 
list lines of the source program. A walk-through of the use of the 
editor to create a small machine language program follows the 
overview. 

Option 3 causes the assembler sub-program to be run. The 
function of the assembler is to translate programs written in assembly 
language into machine language. The assembler finds the assemDly 
language program, called the "source program", in memory m the source 
program area. The program must have been previously created with the 
editor (option 2) or the decoder (option 4) or loaded Dy the loader 
(option 6). The source program is assembled bv the assembler and the 
resulting machine language program is produced. The listing of the 
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program is directed to either the screen or the printer. The machine 
language may be directed to either an "object" file on tape or disk or 
directly POKEed into memory or both. The specifications for the 
creation of assembly language programs are given in Chapter le. 

Option 4 selects the decoder as the sub-program to be run. The 
decoder does the opposite of the assembler. You specify the starting 
and ending addresses in memory which you want to decode and it will 
produce the assembly language program which corresponds to the machine 
language program in memory. The decoder lists the assembly language 
program on the screen and optionally to the printer. It also can 
place the generated assembly language program in the source program 
area of memory where you may access it with the editor and/or the 
assembler. 

Option 5 of the main menu selects the debugger. This tool 
allows you to run any machine language program a single instruction at 
a time. As each instruction is executed it is decoded and all the 
internal registers of the 6510 microprocessor are displayed^ including 
the individual status bits of the processor status register. Any 
memory location may be displayed and any memory location in RAM may be 
modified as may any of the registers. While single-stepping through a 
program any instruction may be bypassed. 

Option 6 selects the LOAD sub-program. This sub-program can 
load two types of files. It is used to re-load source files and to 
load "object files" ( machine language programs which were created 
with the assembler). Files may be loaded from tape or disk. 

Opticm 7 of the main menu selects the SAVE sub-program. SAVE 
allows you to do two kinds of saves. You may save your source program 
which was created with the editor and /or the decoder onto tape or 
disk. Source programs automatically have the suffix ".SRC" appended 
to the file name you assign. They may be re-loaded into the source 
program area by the LOAD sub-program (option 6). Also> blocks of 
memory may be saved as "binary" files which may be re-loaded later 
with the usual BASIC "LOAD" command. The third kind of saving done by 
Develop-64 is done as an option of the assembler. It saves "object" 
files to tape or disk which the LOAD sub-prcgram cah then read and 
poke into memory. These files automatically have the suffix ".OBJ" 
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appended to their file names. O 

Option 8 is used to clear the source program area. It's use is ^ 
required only when you wish to replace the current source program with ^ 
another. 

O 



Using the tools - a tutorial 



The -following tutorial will bring you step-by-step through the ^ 

many uses o-f the tools. The tutorial will not attempt to explain the *^ 

assembly language program or much about the syntax o-f the statements p 
created. For an understanding o-f the rules o-f proper assembly 

statement constructiont see Chapter 10. For an understanding o-f the Q 
way the various instructions cause the 6510 to behave » read Chapters 

6-9. For an understanding o-f the 64-speci-fic parts o-f the program O 

read Chapters 11-13. This tutorial is designed to -familiarize you ^ 

with the mechanics o-f creating a working assembly language program* ^ 

assembling it, loading it into memory and running it both at normal ^ 
speed and at single-step speed. You will also learn how to decode a 

machine language program back into assembly language. O 

Getting going with the editor O 

Develop-64 is waiting -for a menu selection. We wish to create a ^ 
source program -from iscratch so Key a "2" to select the editor. 

The editor menu should now be on the screen. The editor's ^ 
options are: 

1) EXIT 2) LIST 3) INSERT 4) DELETE 5)M0DIFY O 

As mentioned be-fore » option 1 will return you to the master 
menut i.e. exit the editor. Option 2 will list the source program i-f ^ 
there is one to list. We haven't gotten that -far yet. What we want 
to do now is to insert lines o-f a source program into the source O 
program area. So the option to select is "3". Now the next prompt, 
"INSERT AFTER?" will appear. 



Insert mode 

The question the editor is asking is where we want to start 
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inserting our program lines. Each line or statement of assembly 
language will be automatically assigned a line number as it is 
created. You will see that in a moment. At the start of making a 
program the first line number is a "1". So the first insertion will 
come after line number "0". That is the correct response at this 
time. If you ever try to fool the editor by answering with a line 
number higher than the current high line of the program in memory* it 
will just repeat the question until you answer something reasonable. 
Later* when you wish to go back and add lines to your program you will 
specify where you wish to insert your new program statements by giving 
the appropriate line number. 

Once you have responded to the "INSERT AFTER?" prompt* the 
screen will clear and a solitary quote mark (") will appear on the 
second line of the screen with a flashing cursor following. This is 
the place where lines of assembly language programs are entered. It 
is called the "edit window". 

Now to enter the first line of the sample program. Without 
hitting CR3f key in the statement: 

SAMPLE PROGRAM 

The semi-colon should be keyed in the first position after the 
prompt. If you made errors in keying the above statement you may move 
the cursor to the error with the cursor control keys and correct it by 
typing over the error or by using the [delete] and [insert] keys. 
Until [R] is hit* changes may be made at will. Each statement entered 
may be at most 79 characters long. This is two complete screen lines 
minus the quote. 

Hit [R] when you have got the line right. You should see the 
statement appear a few lines lower on the screen with the line number 
1 on the left. This statement is a comment. The fact that it is a 
comment is signified by the ";" in the first position of the line. 
You may place comments anywhere in your program and they have no 
restrictions on their format except for the first character. One 
restriction does apply to this and all other statements entered with 
the editor. Never may you key a quote ( " ) character. 

Now enter the second statement of the program: 

SRC EQU251 SOURCE VECTOR 
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Be sure to leave a space between the labels "SRC" and the 
mnemoniCf "EQU". Be sure NOT to leave any space between the "EQU" and 
the operand* "251". Not Keying a space between these two fields may 
seem unnatural to those who have experience with other 
assembler/editors but it saves you a Keystroke and becomes natural 
very quickly. The assembly listing and listings produced with the 
editor will have a space inserted -for improved readability. 

Another space should be present after the operand and before 
the comment, "SOURCE VECTOR". This is a typical assembly language 
statement. It has all four possible fields present. The label and 
comment fields are not always present and for some instructions the 
operand field is not present either. The mnemonic is liKe the verb of 
the statement and must always be present. It must always have a space 
before it. If there isalabelf there must be only one space 
separating the two fields. If there is no label, the first character 
must be a space and the mnemonic must start in the second position 
after the quote. Comments must always be separated from the preceding 
part of the statement by a space. Note that there are two Kinds of 
comments, those on lines by themselves and starting with a ";" and 
those which are on the same line as the assembly language instruction. 

Once you have the statement Keyed ^st as shown, hit CRD. It 
should appear below the previous line with line number "2". Now enter 
the remainder of the following short assembly language segment, one 
statement at a time. If you maKe mistaKes while entering the program 
you may correct them before hitting CR] on the line in question or you 
may correct the error later with the modify option. 

5 SAMPLE PROGRAM 
SRC EQU251 SOURCE k^ECTOR 
DST EQU253 DEST VECTOR 
SRCE EQU$D806 ORIG CHAR SET 
DSTE EQU$C8ee NEW CHAR SET 
START EQUfceee 

Error Messages 

It is possible you may get an error message or two while keying 
the program. Errors are signaled by an audible "beep" and by a 
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message above the edit window in reverse red letters. The format of 
editor error messages is ERR 1 or ERR 2. When an error occurs* the 
line just Keyed will remain in the edit window until it is corrected. 
ERR 1 signifies a mnemonic which is not valid. ERR 2 signifies either 
a syntax error such as no space before the mnemonic or an extra space 
between the mnemonic and the operand. ERR 2 will also be given if the 
addressing mode is not a legal one for the mnemonic used. A list of 
all the mnemonics and their valid addressing modes may be found in 
Appendix A. 

To exit the insert mode it is necessary only to key a CRU with 
no further entry in the edit window. Once done» the menu will 
reappear and you may select other options as you choose. 

It would be useful to try the modify mode now even if no 
mistakes were made in the original entry. 

NcKJify mode 

To select the modify option key a "5". You will now be asked 
where to begin modifications. 

"BEGIN AT?" should appear on the screen. Give it the line number 
where you would like to begin making modifications. Try a "i". Line 
number 1 should now appear in the edit window waiting for your 
changes. You may make changes or not as you wish. If no changes are 
desired hit CR]. If you wish to make changes* move the cursor to the 
place you wish to change* make the modification and when done* hit 
CR]. You may use the insert and delete keys if you wish. 

Once you have hit CR] the modified line will replace the old 
line and will appear below. Now the next line will appear in the edit 
window for your examination and possible modification. You will stay 
in modify-mode until one of two things happens. Either the last line 
of the program has been modified or you terminate modify-mode by over- 
keying a "/ " in the first character position of the line put up in 
the edit window and hitting CR]. When terminated* the menu will re- 
appear* and Develop-64 will automatically enter list mode as described 
below. 
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List modt 

The source program is listed automatically after exiting -from 
insert mode and -from modify mode and after deleting lines and after 
loading a source program from tape or disk. In these cases the 
listing will be directed to the screen only and the listing will start 
with line 1. It is possible to command Develop-64 to begin listing 
the program at any time you are in the edit sub-program by selecting 
option 2. 

Upon selecting the list option* you will then be asked "BEGIN 
AT?". Give it a line number* such as "1". Next you will be asked 
whether you want the listing to go to the "PRINTER ?". A "Y" or a "N" 
is expected. The "N" response is the default, in which case the 
listing will go on the screen. Whether the list mode was entered 
automatically or by explicit menu selection, while the listing is 
proceeding you may pause it at any time by hitting any key. Hitting 
CR] will cause the immediate return to the menu. You may resume a 
paused listing by hitting any key except CR]. Hitting CR3 will cause 
a return to the menu. 

Imtrt mode revisited 

Insert mode may be entered to insert lines of source in the 
middle of a program as well as for creating one from scratch. With 
the sample program created thus far, select option 3 to re-enter 
insert mode. The "INSERT AFTER?" prompt should be answered with a 
"1". Now several lines of the program segment will be displayed on 
the screen and the edit-window will be open again. Key a single ";" 
character and CR3. This should cause a new line to be entered and 
inserted after line number 1 and it will appear below with the 
following statements automatically renumbered. The empty edit-window 
will re-appear and you may now key another statement to be inserted 
after the one just entered. If you wish, try inserting other 
statements. Anything starting with a ";" will be accepted. To leave 
the insert mode, like before, hit CR] with a blank line. Listing will 
automatically commence. 
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Dtltte Optica 

H you wish to delete some lines from your program the menu 
selection is "4". You will be asked the starting and ending line 
numbers to have deleted. As with insertf upon deleting^ the remainder 
o-f the program will be renumbered. Listing will commence. 

Now you can enter the rest of the program. This program will 
be used in the following chapters to illustrate the use of the other 
tools. It is also an example of creating your own custom character 
set. It is recommended you try it. The effects are unusual. 

The following is a list of the complete program. This list is 
in the format produced by using the LIST option and a printer. It 
inserts a space between the mnemonic and the operand for readability. 
It also lines up the comments for readability. When keying the 
program remember not to key the extra space and only leave one space 
between the operand and the comment. A little practice and it will 
become very natural. 
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1 ; 

2 I 

3 SRC 

4 DST 

5 SRCE 

6 DSTE 



SAMPLE PROGRAM 

EQU 251 
EQU 253 

EQU ^De«e 
EQU scsee 



SOURCE VECTOR 
DEST VECTOR 
ORIG CHAR SET 
NEUI CHAR SET 



7 
8 
9 



ENTRY POINT (tceee = 49152) 



le START 


EQU 


♦ceee 






11 


LDA 


l*>SRCE 


BUILD SOURCE 




12 


STA 


<-SRC+l 


VECTOR 




13 


LDA 


M<SRCE 




14 


STA 


^SRC 




C ' 


15 


LDA 


«»>DSTE 




16 


STA 


<-DST+l 


AND DEST VECTOR 


O 


17 


LDA 


♦»<DSTE 




18 


STA 


<-DST 






19 


LDA 


56334 




o 


2e 


AND 


♦♦♦FE 


INTERRUPTS OFF 




21 


STA 


56334 




o 


22 


LDA 


<-l 




23 


AND 




I/O OUT, ROM IN 


n 


24 


STA 


i-l 




25 


LDX 


1*8 


^ CHAR MEM PAGES 




26 


LDY 


#8 




27 LOOP 


LDA 


(SRC) ,Y 


GET SOURCE BYTE 




28 


PHA 




AND SAVE IT 


29 


TYA 








39 


EOR 


*»7 


FLIP CHAR PATTERN 




31 


TAY 






32 


PLA 




RETRIEVE BYTE 


p 


33 


STA 


<DST) ,Y 


AND STORE IT 


34 


TYA 






p 


35 


EOR 


♦♦7 


FIX THE Y-REG 


36 


TAY 








37 


I NY 




BUMP THE INDEX 


p 


38 


BNE 


LOOP 


AND DO IT AGAIN 




39 


DEX 




PAGE COUNTDOWr^ 


p 


40 


BED 


DOf>IE 






41 


INC 


<-SRC+l 


INCREMENT PAGES 


n 


42 


INC 


<-DST*l 


OF SRC AND DEST 




43 


JMP 


LOOP 


AND KEEP GOING 


p 


44 DONE 


LDA 


<-l 






45 


ORA 


tt4 


ROM OUT, I/O IN 


p 


46 


STA 


<-l 




47 


LDA 


56334 


RE-ENABLE 




48 


ORA 


HI 


INTERRUPTS 




49 


STA 


56334 






5e 


RTS 




RETURN TO BASIC 


n 
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When you have completed the entry of the above program double 
check it for accuracy. Once you have made any necessary modifications 
the source program should be saved. 

Saving a source program 

In the main menu» option 6 is selected to save a source 
program. Once the SAVE sub-program is entered* you will be asked 
whether you wish to save a source or a binary file. The default and 
the correct reply here is source ("S"). Hitting CR3 will cause a 
source file to be saved. You will next be asked whether you want to 
save your source program to tape or disk. Reply as is appropriate for 
your system. Finally* you will be prompted for the name you wish to 
assign to the file. Whatever name you give* Develop-64 will 
automatically append the suffix of ".SRC" When re-loading the same 
file in the future you will only be required to specify the base name* 
not the suffix. Object files* when saved out of the assembler sub- 
program will be created with the suffix of ".OBJ". Note that either 
type of save will cause any previous version by the same name and with 
the same suffix to be deleted and replaced by the file you are now 
creating. 
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Using Develop— 64 — II 

Prtparing to use the assembler 

The assembler sub-program will process a source program and 
produce an object program. The object program is the machine language 
which is the ultimate objective o-f writing an assembly language 
program. The source program must be in Develop-64's source program 
area. A source program may get into the source program area via the 
editor^ decoder and loader subprograms. In the previous chapter the 
use of the editor to create a sample source program was described. If 
the source program is still in the source program area you may now 
assemble it by selecting option 3 of the main menu. If not» you will 
have to create a program with the editor or load a saved source 
program with the loader. The procedure for using the loader is given 
below. 

Loading a soiree program 

Option 6 selects the loader sub-program. The first question 
asked is whether you wish to load a source or ob^ct file. The 
possible responses are "S" and "0". "S" is the default and you need 
only hit CR3. You will now be given your choice of loading the file 
from disk or tape (D/T). Respond appropriately for your system. The 
next question you must answer is what file name Develop-64 is supposed 
to find and load. When source files are saved with the SAVE sub- 
program, the suffixt ".SRC" is automatically appended to the file name 
you gave it. It is not necessary to add that now to the file name to 
load. The loader will automatically find and load the file with the 
name you specified plus the appended suffix. 

Finally t you will be asked where in the source program area you 
wish to have the source program loaded. That is# after which line 
number do you want the file inserted. If you already have a program 
in the source program area and want this one to replace it you must 
precede the load process with a "NBW" (option S). It is possible to 
merge multiple source files by not NEWing between loads. In this case 
you must tell Develop-64 where you want each file inserted and as the 
files are loaded they will be inserted accordingly » with the program 
already in the source area being automatically renumbered to reflect 
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the insertion. 

In the case o-f loading a program into an empty source program 
area* the correct response to the "INSERT AFTER?" question is "0". 
Once the program is loaded the list mode o-f the editor sub-program 
will be automatically entered. 

Assembling the source program 

To enter the assembler sub-program it is necessary to select 
option "3" of the main menu. The -first question you must answer is 
"DEC/HEX (D/H)? You are being asked how you wish to see the generated 
machine language displayed on the assembly listing. The two possible 
responses are "D" and "H". Addresses and data will both be displayed 
in the -format you select. I-f you hit CR] the default value of "D" for 
decimal will be used. The hexadecimal choice causes the assembly to 
run somewhat slower. 

The next prompt will be "POKE ?". If you answer "Y" the 
generated machine language program will be POKEd directly into the 
memory of the computer. This can be dangerous if the memory addresses 
where the program is designated to reside overlap the memory space 
where Develop-64 itself resides. This is called self-destruction and 
will not give pleasant results. There are several ways to avoid this 
problem: i) Design the machine language program to reside in "sacred 
RAM" starting at $C0ee (49152). 2) Don't select the POKE option. Use 
the next option which creates an "object file" which can then be 
loaded with a three statement BASIC program. 3) Set the start and end 
of Develop-64's address space to addresses which will preclude it from 
being in the space which will be occupied by the eventual machine 
language program you are creating. This is done at the very beginning 
of Develop-64. 

All these options are explained in more detail in the Chapter 
5. For the sample program it doesn't matter how you respond since the 
program is set up to reside in sacred RAM. 

The next question^ "CREATE OBJECT ?", is asking whether 
Develop-64 should build a file of the machine language output which 
can then be loaded later with the loader sub-program. This is a 
convenient way of saving the machine language program. The loader 
sub-program is a very small routine which could be very easily 
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incoppopated into a BASIC ppogpam. This allows you one means o-f 
writing a BASIC ppogram which has machine language subroutines. In 
the next chaptep we will ppesent Just such a BASIC ppogpam which calls 
the sample ppogram. You should answer "Y" to this question i-f you 
wish to follow the sample ppogpam thpough to its completion. 

Once done, the next question is "DEVICE (D/T) ?" This is 
asking you whethep you wish to save the genepated machine language 
object file to tape op disk. Answep as is apppoppiate fop youp 
system. Nextt Develop-64 wants to know what you want to call the 
-file. Whatevep you pespond to "FILE NAME ?" the actual name assigned 
will have the su-ffix of ".OBJ" automatically appended. You may pick 
any name you wish but the ppogpam given in the next chaptep assumes a 
file name of "SAMPLE". 

Finally, Develop-64 wishes to know if you want the assembly 
listing to go to a ppintep. If you answep "Y" the listing will go 
only to the ppintep. If you answep "N" the listing will be displayed 
on the scpeen only. 

When this final option is selected, Develop-64 will display the 
message "NOW ASSEMBLING" and the fipst pass of the assemblep will 
commence. When completed, the assembly listing will begin to appeap 
on the selected listing device. On the scpeen, the soupce line will 
appeap fiPst, followed by the machine language which the assemblep 
cpeated. The line numbeps will appeap on the second line along with 
the machine language. The machine language is visually sepapated fpom 
the soupce by being displayed on the scpeen in pevepse and on the 
ppintep to the pight of the soupce statement. Eppops ape displayed 
both on the ppinted listing and in pevepse ped on the scpeen, 
accompanied by a wapning "beep". 

Error messages 

There ape foup eppops which the assemblep pecognizes. Each is 
displayed on the line with the genepated machine language in the 
fopmat: "ERR 3 FIELD" whepe the numbep aftep the ERR may be 3, 4, 5 op 
6 and FIELD will be the actual data the assemblep found in eppop. 

BRR 3 means a label specified in an opepand cannot be found 
anywhepe in the soupce ppogpam. ERR 3 can also occup on the fiPst pass 
of the assemblep and signifies that an EQU statement has a label in 
the opepand field which has not yet been encounteped in the souPce 
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program. 

BRH 4 means a relative branch instruction such as a BNE or a 
BPL instruction is attempting to specify a branch to an address 
outside the range o-f the instruction. 

BRR 5 means an invalid character has been encountered in a 
hexadecimal term of an address expression. 

BRR 6 means that an address has been specified which is out of 
the range of -65536 to 65535. 

For detailed descriptions of the specifications for writing 
valid assembly language programs see Chapter le. 

While the listing is being generated » it is possible to pause 
it by hitting any key. If the key hit is CR3> the assembly will 
terminate and the main menu will reappear. Once it has been pausedi 
you may continue by hitting any key except CR3. Hitting CR3 will 
cause the main menu to reappear. You may at any time re-assemble by 
re-selecting option 2 of the main menu. If you have not selected 
insert^ delete or modify options of the editor or have not done a 
source file load since the last assembly! the first pass will be 
bypassed* allowing speedier assembly. 

If you have actually created the sample program and assembled 
it> selecting printer output* you should have received a program 
listing similar to the following listing. 



n 
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FRENCH SILK DEVELOP-64 ASSEMBLY LISTING 



1 
2 

3 SRC 

4 DST 

5 SRCE 

6 DSTE 

7 \ 

8 I 

9 I 



I SAMPLE PROGRAM 
I 

EQU 251 
EQU 253 
EQU $0080 

EQU »c8ee 



SOURCE VECTOR 
DEST VECTOR 
OR 1 6 CHAR SET 
NEW CHAR SET 



251 
253 
53248 
51200 



ENTRY POINT (tCOOO - 49152) 



1 


START 


EQU 


SC000 




491 52 




1 1 




LDA 


M>SRCE 


BUILD SOURCE 


491 52 


169 208 


1 2 




STA 


^9PQ4 \ 


VECTOR 


491 54 


1 33 252 ' 


1 3 




LDA 


N<SRCE 




491 56 


1 69 


14 




STA 


4-SRC 




49158 


133 251 


15 




LDA 


*»>DSTE 




49160 


169 200 


16 




STA 


^DST* 1 


AND DEST VECTOR 


49162 


133 254 


17 




LDA 


♦»<DSTE 




49164 


169 


18 




STA 


«-DST 




49166 


133 253 


19 




LDA 


56334 




49168 


173 14 220 


20 




AND 


M«FE 


INTERRUPTS OFF 


49171 


41 254 


21 




STA 


56334 




49173 


141 14 220 


22 




LDA 


^1 




49176 


165 1 


23 




AND 


M^FB 


I/O OUT, RWi IN 


49178 


41 251 


24 




STA 


♦•I 




49180 


133 1 


25 




LDX 


tt8 


« CHAR MEM PAGES 


49182 


162 8 


26 




LDY 


M0 




49184 


160 


27 


LOOP 


LDA 


<SRC),Y 


GET SOURCE BYTE 


49186 


177 251 


28 




PHA 




AND SAVE IT 


49188 


72 


29 




TYA 






49189 


152 


30 




EOR 


M7 


FLIP CHAR PATTERN 


49190 


73 7 


31 




TAY 






49192 


168 


32 




PLA 




RETRIEVE BYTE 


49193 


104 


33 




STA 


<DST) ,Y 


AND STORE IT 


49194 


145 253 


34 




TYA 






49196 


152 


35 




EOR 


♦♦7 


FIX THE Y-REG 


49197 


73 7 


36 




TAY 






491^9 


168 


37 




INY 




BUMP THE INDEX 


49200 


200 


38 




BNE 


LOOP 


AND DO IT AGAIN 


49201 


208 239 


39 




DEX 




PAGE COUNTDOWN 


49203 


202 


40 




BEQ 


DONE 




49204 


240 7 


41 




INC 


<-SRC+l 


INCREMENT PAGES 


49206 


230 252 


42 




INC 


<-DST* 1 


OF SRC AND DEST 


49208 


230 254 


43 




JMP 


LOOP 


AND KEEP GOING 


49210 


76 34 192 


44 


DONE 


LDA 


<-l 




49213 


165 1 


45 




ORA 


M4 


ROM OUT, I/O IN 


49215 


9 4 


46 




STA 


<-l 




49217 


133 1 


47 




LDA 


56334 


RE-ENABLE 


49219 


173 14 220 


48 




ORA 


Ml 


INTERRUPTS 


49222 


9 1 


49 




STA 


56334 




49224 


141 14 220 


50 




RTS 




RETURN TO BASIC 


49227 


96 



o 
o 

rs 
n 
n 
n 



n 
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If you did not select the printer option^ the listing you got 
on the screen should have been similar* except that the machine 
language is on a line by itself. If there are any differences* 
particularly in the machine language portion of the listing* there is 
something significantly wrong with your source program. If you 
received errors while assembling you must find the source of your 
mistake* use the editor to correct it and go back and re-assemble. 
Once it looks right* proceed to the next chapter. 
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H you did not select the printer option^ the listing you got 
on the screen should have been similar, except that the machine 
language is on a line by itself. H there are any differences, 
particularly in the machine language portion of the listing, there is 
something significantly wrong with your source program. If you 
received errors while assembling you must find the source of your 
mistake, use the editor to correct it and go back and re-assemble. 
Once it looks right, proceed to the next chapter. 



Xntide Tht Commodort 64 Pagt S-i 

Using Dovelop—^A — III 

Loadir^ and running the machine language program 

If you have created and assembled the sample program described 
in the past two chapters and have created an object file as described 
you can now use the following BASIC program to load and run the 
program. Note that the first two lines of the program are written 
for the disk user but the cassette user can eliminate line 7 and 
change line 5 to: 5 OPEN late/'SAMPLE.OBJ" 



5 OPEN1,8,2,"0:SAMPLE.OBJ,S" 

7 CL0SE15:0PEN15,8,15:INPUT«15,A,B$,C,D:IF A THEN 

PRINT A,B*,C,D:CL0SE1 :CL0SE15!ST0P 
18 INPUTMljNs IFN=-1800 THEN CLOSEl s GOTO30 
28 IF N<1 THEN POKE P,-N! P=P+l:GOTOie 
25 P=N:60T018 

38 POKE 648,196: POKE 56578, PEEK< 56578) OR 3: 
POKE 56576, PEEK( 56576) AND 252: SYS 49152 
48 POKE 53272, (PEEK< 53272) AND 248) OR 2 
58 PRINT "CCLR3 MIRROR, MIRROR ON THE CEILING" 



It is assumed that the name you gave to the file when the 
assembler sub-program asKed for file name was "SAMPLE". If it was 
something else, substitute that for "SAMPLE" in line 5. 

The three POKES in line 38 are set-up preliminaries in 
preparation for running the machine language program. They could have 
jusi as easily been done in the machine language program. Chapter 11 
on graphics programming explains in detail the process which is being 
performed here. 

The jump into the machine language program is accomplished by 
the SYS 49152. Note that the first non-EQU instruction in the 
assembly language program has an address of 49152 ($0888). This is 
the first executable statement of the program. It is called the entry 
point of the program. Its address was determined by the EQU 



n 
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immediately preceding it. As explained in Chapter 10, the address in 
RAM where the machine language program gets POKEd is set each time an 
EQU is encountered in the source program. The assembler writes the 
address expressed in the EQU to the file as a positive decimal 
number. It writes the bytes of machine language to be POKEd as 
negative numbers. The little loader routine thus can identify every 
EQU and change the address at which to start POKEing subsequent 
machine language. 

The POKE in line 40 of the BASIC program could also have been 
included in the machine language program. Its function is also 
explained in Chapter 11 in the section labeled multiple character 
sets. 

If all went as planned » the results of running the above 
program should be apparent. All screen output from now on will appear 
upside down. (Try listing the BASIC program, for example). You may 
escape from this mode only by turning the machine off or by typing 
SYS 64738 CR3 or by doing some POKEs to switch the character set back 
to its usual state. 

If the program did not seem to work as advertised, you will 
need to back up and try to find the error. Please, before calling the 
author, do your best to try to find the problem. Look for 
discrepancies between your source program and that listed in the book. 
If you got an error message on trying to load the object file, find 
out why. Go back and re-assemble if other strange things occur. 
Select the POKE option and then use the decoder sub-program, described 
below, to decode the machine language to compare the generated 
assembly language with the original sample program. (Note: the 
listing of the sample program given in this book came directly from 
Develop-64 and DOES work. It is also highly unlikely that Commodore 
has made a change in the design of the 64 which will cause the sample 
program to be ineffective.) 

On the other hand, if you have exhausted all other 
possibilities and it certainly appears that something is amiss, please 
send us a copy of your Develop-64, a written description of the 
problem, and any other relevant information and data files which can 
assist us in finding the source of the problem. 



n 
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Decoding the program 

Now that you have a working copy o-f the sample program in 
memory it would be a good time to see what the decoder can do for you. 
If you just ran the sample BASIC program which loaded and ran the 
machine language program you can get back to normal characters without 
losing the machine language program by typing SYS 64738. H the 
machine language program is not in memory you should put it there by 
assembling the source program and selecting the POKE option to POKE 
the output into memory as the program is being assembled. 

Load and run Develop-64. Select the decoder option of the main 
menut option 4. Your next menu will be: 

1) EXIT 2) PRINTER 3) SCREEN 4) INSERT 

All three options to decode machine language will cause the 
generated assembly language to appear on the screen. If option 2 is 
selected the output will go to your printer as well. If option 3 is 
selected the lines of assembly language will be inserted into the 
source program area where they may be modified and/or assembled and/or 
saved. If insert is selected the "INSERT AFTER ?" prompt will be 
given and you must tell Develop-64 where you want the source inserted 
in the current source program. If there is already a program in the 
source program area and you want this one to replace it» it will be 
necessary to clear the area with the NEW option (8) of the main menu 
before proceeding with the decoder sub-program. 

In every case, the first prompt will be "DEC/HEX (D/H) ?", 
asking whether the generated source should have addresses and data in 
hexadecimal or decimal format. Hex causes the decoder to run about 
twice as slow as decimal. 

The next prompt will be "START, END ?", asking for the 
addresses in memory between which you would like to decode. You may 
give your answers in either hex or decimal. Hex values must be 
preceded by a"$". The end point may be expressed as data value 
instead of an address. By precedeing the data value with a "#", the 
decoder will be directed to decode until it recognizes the specified 
data value in the op-code of an instruction. For example, if you 
want to decode until the end of a subroutine, you could specify an end 
address of #96 or #$60 which will cause the decoder to decode until it 
encounters a RTS instruction (value of 96 or $60). 
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If you have the sample machine language program in memory you 
may now decode it. For the purposes of this demonstrateion, select 
option 4 to INSERT. Answer "0" to the "INSERT AFTER?". Specify a 
starting address of $C0O0 and an ending address of #$60» the op-code 
for the RTS instruction. 

The generated output should look very much but not exactly like 
the original source program which created it. The differences are due 
to the fact that the decoder can not create comments. Nor does it 
generate labels. 

The decoder sub-program can decode any memory block in the 
computer^ including the operating system. It can also decode 
cartridges if the cartridge is activated after power-on. The reason 
for this exception is that if a cartridge is in place when the power 
is turned on the power-up program in the computer will automatically 
give control to the program in the cartridge. Since most cartridges 
will not allow any means of giving control back to another program 
there is no way for Develop-64 to be run. The most common way to 
defeat this is to have the cartridge plugged into an expansion chassis 
which has switches which activate and de-activate the cartridges which 
are plugged into it. Then the procedure is to power-up with the 
cartridge de-activated» load and run Develop-64t then activate the 
cartridge. Since the only time control is passed to the cartridge is 
at power-up» the cartridge is not now in control* yet it is 
addressable by the decoder. There are some cartridges which are 
designed to cause BASIC to be "switched out" when they are activated. 
These cartridges may not be possible to decode with Develop-64. 

As a matter of curiosity* you could now exit the decoder and 
enter the assembler and re-assemble the decoded program. The machine 
language which is generated will be exactly the same as the machine 
language which was generated from the original source program. 

Below is a listing of the re-assembled output of the decoder. 
Note that the generated machine language from the assembler is 
identical to the generated machine language of the original assembly. 
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FRENCH SILK DEV^ELOP-64 ASSEMBLY LISTING 



1 


EQU 


49152 


49152 


2 


LOA 


M298 


49152 169 298 


3 


STA 


^252 


49154 133 252 


4 


LDA 


#9 


49156 169 9 


5 


STA 


<-251 


49158 133 251 


6 


LDA 


«*299 


49169 i69 299 


7 


STA 


^254 


49162 133 254 


8 


LDA 


1*9 


49164 169 9 


9 


STA 


4-253 


49166 133 253 


le 


LDA 


56334 


49168 173 14 229 


11 


AND 


#254 


49171 41 254 


12 


STA 


56334 


49173 141 14 229 


13 


LDA 


4-1 


49176 165 1 


14 


AND 


4*251 


49178 41 251 


15 


STA 


♦•1 


49189 133 1 


\6 


LDX 


#8 


49182 162 8 


17 


LDY 


«*9 


49184 169 9 


18 


LDA 


(251) ,Y 


49186 177 251 


\9 


PHA 




49188 72 


22 


TYA 




49189 152 


21 


EOR 


#7 


49199 73 7 


22 


TAY 




49192 168 


23 


PLA 




49193 194 


24 


STA 


(253) ,Y 


49194 145 253 


25 


TYA 




49196 152 


26 


EOR 


♦♦7 


491 97 73 7 


27 


TAY 




49199 168 


28 


I NY 




49299 299 


29 


BNE 


3-15 49186 


49291 298 239 


39 


DEX 




49293 292 


31 


BEQ 


3+9 49213 


49294 249 7 


32 


INC 


4-252 


49296 239 252 


33 


INC 


♦•254 


49298 239 254 


34 


JMP 


49186 


49219 76 34 192 


35 


LDA 


<-l 


49213 165 1 


36 


ORA 


#4 


49215 9 4 


37 


STA 


4-1 


49217 133 1 


38 


LDA 


56334 


49219 173 14 229 


39 


ORA 


Ml 


49222 9 1 


49 


STA 


56334 


49224 141 14 229 


41 


RTS 




49227 96 
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Using - IV 

Using the debugger 

The debugger sub-program provides the capability of running a 
machine language program one instruction at a time. As each 
instruction is executed* the internal registers o-f the Commodore 64's 
6519 microprocessor are displayed* including the individual bits o-f 
the status register. The instruction to be executed is also 
displayed* both in machine language and in assembly language. The 
capability is provided to bypass the execution o-f any instruction and 
to display and modify any memory location while in the process of 
running the program. The debugger sub-program may be selected by 
selecting option 5 of the main menu. The menu of debugger options is: 

1) EXIT 2) START S/S 3) EXECUTE 4) BYPASS 
5) MEMORY D ISP/MOD 

For the purpose of demonstrating the features of the debugger 
you should have loaded into memory the program created* assembled* 
loaded and run in the previous chapters. 

Option 2 is the menu option to set the address of the next 
instruction to be executed. It will be followed first by the "DEC/HEX 
(D/H) ? prompt* then the "START ADDR ?" prompt* asking for the 
starting address. Valid replies are decimal numbers in the range of 0- 
65535 and hexadecimal numbers in the range of $0d0O-$FFFF. 

Option 3 is the default option and may be selected by hitting 
CR3. It is not to be used until option 2 has been selected to set the 
first address to execute. Selecting this option causes the current 
instruction to be executed. This will be clarified as you single-step 
through the sample program. 

Option 4 will cause the instruction about to be executed to be 
bypassed. Rather than execute the displayed instruction* the 
instruction following the displayed one will be displayed. 

Option 5 causes Develop-64 to enter the memory display /modify 
mode. This is also followed by the "START ADDR" prompt* requesting 
the starting address of displaying/modifying. 
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The sample program explained 

At this time you can see the "slow-motion" execution of the 
sample program. If you don't know much about machine language or the 
architecture of the 6510 microprocessor this exercise may not maKe a 
lot of sense to you. You may want to skip ahead and read the Chapters 
6-9 to gain an understanding of the machine. It could also be helpful 
to ^st walk through the following explanation prior to having a 
fuller understanding just to familiarize yourself with the mechanics 
of using this tool. Either wayt if you are jjst getting started with 
machine language » it is recommended you return to this chapter after 
having studied the following chapters, 

Key a "2" if you wish to single step through the sample 
program. Answer the "START ADDR" prompt with ICeoe, the address of 
the entry point of the program. The first instruction of your program 
should now appear on the screen. 

As each instruction is about to be executed, it is displayed in 
both machine language and in assembly language. The processor status 
(PS) register is broken into its individual bits (N = negative, V = 
overflow, B = break mode, D = Decimal mode, Z = Zero, I = interrupts 
inhibited, C = Carry). The other registers displayed are the A-reg, 
the X-reg, the Y-reg, and the Stack Pointer (SP). Upon execution of 
each instruction, the registers are loaded from these save areas in 
memory: 

A-78e X-781 Y- 782 PS - 140 

If you wish to modify or pre-initialize any of the registers 
at any time you may do so by entering the Memory-Modify mode and 
modifying the above locations. 

If, while single-stepping through some program, you should 
execute a RTS or PLA or PLP without first having pushed something onto 
the stack with a JSR or PHA or PHP, a stack underflow will occur. A 
TXS instruction setting the SP to some out-of-range value will also 
cause stack underflow. Overflows are caused by repetitive PHA's PHP's 
or JSR's without corresponding PLA's PLP'S or RTS's until the maximum 
stack depth has been exceeded. In the event of underflows and 
overflows, a "STK ERR" message will be displayed. Execution may 
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continue if desired but results are likely to be unexpected ii your 
monitored program is expecting to -find some significant information in 
the stack (like a return address). 

Certain machine language programs are written to modify the 
Stack directly by storing data in the high end of page i. Executing 
these instructions in debugging mode will not cause the desired stack 
modification effect. In fact, it is quite likely that Develop-64 will 
actually crash upon the execution of such instructions. Since it is 
written partially in BASIC* any instructions which modify the BASIC 
vectors or other information vital to the running of BASIC programs 
may also cause unwanted results. 

As Develop-64 single steps through a machine language program, 
it checks each op-code encountered for validity. If an invalid op- 
code is encountered, the message "OP-CODE = xxx" (where xxx is the 
encountered op-code) will appear where the mnemonic would otherwise 
appear. Develop-64 will not try to execute invalid op-codes. Nor will 
it try to execute BRK or RTI instructions. All of these will be 
automatically bypassed. 

If the sample program is now in memory and you have selected 
the single-step option and specified address $0000 as the starting 
address and selected decimal as the display format, you should see on 
the screen the assembly language statement "LDA #208" followed by the 
address 49152 and the machine language equivalent of the above 
assembly language statement: 169 208. 

On the next line will be the display of the registers, the A- 
reg, X-reg, Y-reg and SP(the stack pointer), prior to the execution of 
the displayed instruction. You will also see the status register 
displayed broken down into its component bits, the Negative, oVerflow, 
Break, Decimal, Interrupt disable. Zero and Carry flags. The 
registers will have no particular significance at this point because 
they were never initialized. Note, however, the value of the A-reg 
because after executing the instruction it will probably change. The 
Zero flag, if it is a one now should also change as a result of the 
execution of the instruction. The Negative flag is also affected by a 
LDA instruction. 

Note the disassembled statement is not identical to the 
assembly language statement you originally wrote. It is equivalent 
but not identical. The original statement was: LDA #>SRCE. This 
discrepancy occurs because The Monitor can't tell what went into the 
assembler, only what came out and it does the best it can in 
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reconstructing a valid assembly language statement from the machine 
language it has to work with. 

To execute the instruction* hit return. H all is well, the 
next instruction of the sample program will be displayed and the first 
instruction will have been executed. You may verify that by checking 
the A-reg. It should be of value 208 now. The zero bit should be a 6 
because the result of loading the A-reg is non-zero. Note that the 
resulting value in the A-reg does have the high-order bit on (i.e. the 
number in the A-reg is greater than 127 or $7F). Consequently, the 
Negative flag should now be turned on. 

The next instruction which is now up for execution will store 
the A-reg in location 252. None of the status flags are affected by 
this instruction so we should see no change when we execute it. Push 
CR] and see. 

This would be a good time to look at the Memory Display /Modify 
mode. Rather than hit CRD at this time, key "5 CRD". 

Upon entering this mode, the address where you left off in 
single-stepping will be saved and the "START ADDR" prompt will be 
displayed. You may enter the first address you wish to examine or 
modify. The address may be in the range 0-65535 or $00O9-$FFFF. To 
look at location 252, key a "252 CR3". The address (252) will be 
displayed followed by the contents of the specified location. In this 
case it should be 268 because that is the value we Just stored there. 
The value of the data stored at the requested address will be 
displayed and the prompt " VAL?" will follow. You may do one of three 
things. You may eXit the Memory mode by keying "X CR3". You may 
modify the displayed location by keying a value in the range 0-255 or 
$00-$FF. Or you may continue viewing the next sequential memory 
locations by hittng CR]. 

You may now change the contents of location 252 if you wish by 
keying some new value. The next location will now be displayed, 
memory location 253. Note its contents and modify them if you wish. 

To Ajst scan through memory, simply continue to hit CR] each 
time a value is displayed. When you wish to return to the main menu, 
key "X CRT* for exit. Once this has been done, the instruction you 
left off at will be redisplayefl along with the menu. If you 
modified location 252 you shduld now re-enter M-mode by entering the 
"5" option, and address 252 again. When the value you stuck in 252 is 
displayed, change it back to and hit CRD, and when location 253 is 
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displayed^ hit "X CRD" to get out again. 

The next instruction in the program is now displayed. It is a 
LDA instruction. Note the registers still have the same contents as 
before the M-mode excursion. The A-reg will be loaded with the value 
9 by the instruction to be executed next. 

This program is setting up a vector in locations 251 and 252 
of zero page to address character ROM at $DOee. A loop in the program 
will sequentially move characters from that area in memory to an area 
where an alternate character set will be built. Hit CR] and see the 
next instruction which is a Store of the A-reg to location 251. Hit 
CR] again. The next four instructions build another vector at 253 and 
254. This is the vector which points to the location where the new 
character set will reside. Hit CR] to execute each of these 
instructions. You may verify that locations 251-254 contain the 
addresses of the two vectors by going into memory display mode if you 
wish. 

The next three instructions cause the timer to be turned off. 
Location 56334 is one of the registers associated with the hardware 
timer which interrupts the Commodore 64 60 times a second. As 
explained in more detail later» the character ROM starting at $D000 
(53248) shares its address space with input/output (I/O) registers. 
To read the character ROM» it is necessary to switch the I/O out and 
switch the ROM in. The only problem with doing this is that the I/O 
registers are used in the servicing of interrupts. So» while the I/O 
is switched out to access the character ROM the timer must be turned 
off 50 as to discontinue interrupts. One of the things the operating 
system does when it processes the interrupts every 1/60 th of a second 
is to poll the Keyboard to see if any Keys have been pressed. Since 
we need to have that function intact while running the debugger^ we 
can't really allow the interrupts to be disabled. So it is necessary 
to bypass the instruction at 49173 which accomplishes the disabling. 
This is where the bypass option is useful. When that instruction is 
displayed* about to be executed* press "4" instead of CR]. 

The switching-in of the ROM is accomplished in the next three 
instructions. The 6510, as explained at the end of Chapter 7, uses 
location 1 as an I/O port and the 2-bit controls whether the ROM or 
the I/O registers are switched in. The AND #251 instruction 
accomplishes the turning off of that bit. Now* since we had to leave 
the interrupts enabled* we can't switch out the I/O registers since 
they are used in processing the interrupts. If you should maKe the 
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mistaKe o-f executing the instruction at 49180 the computer will hang 
and there will be no recourse except to turn it of-f and back on again 
and start over. 

Nextj the X and Y registers are set up to count the number o-f 
times through the following loop. The instruction which is at 49186 
was labeled LOOP in the original source. This instruction will load 
the A-reg with the byte at the location computed -from the sum of the 
contents of the Y-reg and the address vector in locations 251 and 252. 
An unfortunate conseouence of not being able to switch in the 
character ROM is that the data being loaded is not the same as it is 
when the program is run at full speed. 

If you take the value stored at location 252 (208) ♦ which is 
the page # of the character ROM) and multiply it by 256 and add the 
value stored in location 251, (0), you will get the base address to 
which the Y-reg is added. All vectors work the same way: add the 
contents of the first byte of the vector to 256 times the second byte 
to get the address being referenced. 

The next instruction, the PHA, saves the retrieved byte onto 
the stack. Note the value of the SP (stack pointer) before and after 
executing this instruction. 

Next, there is a three instruction trick played with the Y-reg 
to cause the eventual turning upside-down of the characters. The 
flipping of each character top-to-bottom requires a knowledge of how 
character information is stored in memory. It turns out to be a 
fairly simple process but one which can be better understood by 
reading Chapter 11. Suffice it here to say that a simple manipulation 
of the Y-register modifys the sequence in which the character 
information occurs in the new character set. 

The PLA instruction pulls the saved byte of character 
information back off the stack. You can see the stack pointer being 
modified again as the PLA instructions is executed. Once the byte is 
back in the A-reg# it is stored in the new character set in a 
position determined by the source vector at 253,254 and the value of 
the Y-reg. 

Since the Y-reg was manipulated to cause the flipping over of 
the character, it must now be fixed back to its original value before 
the modification. The next three instructions, TYA, EOR #7, and TAY 
do the trick. This is just the reverse of the operation which 
modified it in the first place. 

Once the Y-reg is restored, its use as a loop counter is 
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employed. The INY instruction bumps it up by one and the next 
instruction tests it to see i-f it has gone past 255$ its maximum 
value. I-f it has^ it will have the value o-f zero. The BNE 
instruction tests the zero bit oi the status register and as long as 
it is off (a zero)» the branch will be executed and the next 
instruction to be executed will be at th^ top of the loop at 49186. 
Once the Y-reg gets incremented past 255 to 0» the program will "fall 
through" to the DEX instruction. This will happen after the 256 
sequential bytes of data in the first page of the character ROM have 
been moved to the new character set location. 

Stepping through a few cycles of the loop would be instructive 
for the newcomer to machine language programming. There are eight 
pages of 256 bytes each of character information which needs to be 
moved. The Y-reg is used not only to count through the 256 bytes of 
each page but also to index the address where data is being retrieved 
from and stored to. If you step through the loop eight times and 
record the value of the Y-reg prior to executing the instruction at 
49i86 and prior to executing the instruction at 49194 some insight may 
be gained into the technique employed. Go through it another eight 
times and see that the pattern repeats. 

You may continue through the rest of the program to see it to 
completion without going through 2048 (8 times 256) cycles of the 
loop. Here is another place the bypass option is useful. To get out 
of the inner loop which terminates at the BNE instruction at 49201 you 
may select option 4 instead of executing the branch instruction. This 
will cause the program to "fall through" to the next instruction, the 
DEX. Following the DEX is the instruction which tests to see if all 
eight pages have been processed. If not, the vectors for the source 
and destination LDA and STA instructions are increased and the inner 
loop is entered again for another 256 iterations. To get past doing 
this again, the JMP instruction at 49210 must be bypassed. 

The last seven instructions in the program switch the I/O back 
in and re-enable the interrupts and return to the calling program. 
These may be executed without danger. Executing the last instruction, 
the RTS, will cause a stack error. This is what should be expected 
because the return from subroutine was not preceded by a ^mp to 
subroutine. The SYS instruction in the BASIC program was the intended 
means of getting to the machine language program. The RTS is the 
intended means of returning to the BASIC program." 
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Ma.king the Fina.1 Product 

There are several places where machine language (ML) programs 
may be designed to reside. These include: 1) Inside a BASIC program 
2) Before or after the BASIC program. 3) In the cassette buffert 
$33C-$3FB (828-iei9) 4) In "sacred" RAM at $Cee0-$CFFF (49152-53247). 
5) Anyplace that Develop-64 itself does not reside. 6) Anywhere in 
memory that a "mini-loader" program can address. 

Inside a BASIC program 

To get a ML program into a BASIC program so that it may be 
saved with the BASIC program and reloaded right along with itt a 
couple of techniques may be used. 

The first way is to load a BASIC program with several REM 
statements which take up space and will be overlaid by the ML. The 
token for the first REM must not be overlaid but everything after it 
can be. 

To find the address where the REM statement of your BASIC 
program is stored it is necessary to understand how BASIC programs are 
structured. Each line of a BASIC program is stored in memory in a 
condensed fashion. All the "keywords"* such as GOTO* FOR* PRINT* etc. 
are stored as a single byte of data, called a token, preceding the 
condensed BASIC line is four bytes of system information. The first 
two bytes are a link address pointing to the next BASIC statement 
following this one. The second two bytes are the line number of this 
BASIC statement. At the end of each statement is a single byte with 
value 0. This is the statement terminator. 

The last BASIC statement in the program has a link address of 
0. The first statement in the program is pointed to by an address 
vector stored in locations 43 and 44. Once your program is in memory 
you may find the address of any given statement by searching for the 
line number with the following short statement which may be entered in 
direct mode (does not have to be in a program). 

I=43:FORJ=lTOie0ee:I=PEEK(I)+256*PEEK(I+i):IFPEEK(I+2)+ 
PEEK(I+3)*256<>...THEN NEXT 



Where the appears you must key the statement number you 
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are searching -for. When the "READY." reappears on the screeni the 
variable I will contain the address of the -first byte o-f the statement 
you are searching for. Simply PRINT I. The value printed will be the 
address o-f the first byte of the link address which precedes the 
actual statement in memory. The address of the first byte of the 
statement will be four greater than the value of I. 

The ML program you wish to include with your BASIC program may 
be of greater length than what may be accomodated by a single BASIC 
REM statement. The solution is to have multiple REMs. Before 
overlaying them» it will be necessary to change the link address 
preceding the first one to point to the statement following the batch 
of statements to be overlaid. So it is necesary to find the address 
of the statement following the overlay area using the technique above* 
and to modify the link at the beginning of the area accordingly. 

For example* if the address of the first statement to be 
overlaid is 5000 and the address of the first statement after those 
to be overlaid is 6000, the following POKEs would do the ^b: POKE 
5001,6000/256: POKE 5000,6000-PEEK(500i)*256. This would allow you to 
save a ML program from 5005 (the byte after the REM token), to 5999 
(the byte before the terminator of the last REM overlaid). 

There are two places within your BASIC program which make sense 
to use for the overlay area. There are advantages and disadvantages 
to both. 

If you place it anywhere but the beginning, the problem exists 
of having the machine language program shifting locations every time a 
modification is made to the BASIC program. This can be a ma^r 
problem if the ML has non-relocatable code, e.g. a JSR instruction to 
some fixed address within the program. Non-relocatable programs 
should therefore overlay the beginning of a BASIC program where 
modifications to subsequent statements of the BASIC program will not 
cause any shifting of the position of the ML. 
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An example of such a program would be: 
10 6010108 

20 REMl 234567890 1 234567898 1 234567890 1 234567890 . . . 
30 REMl 234567890 1 234567898 1 234567898 1 234567898 . . . 
48 REMl 234567898 1 234567898 1 234567890 1 234567890 . . . 
50 REM1234567890123456789012345678901234567890 . . . 
68 REMl 234567898 1 234567898 1 234567898 1 234567898 . . . 
78 REM1234567898123456789812345678981234567890. . . 
88 REMl 234567898 1 234567898 1 234567898 1 234567898 . . . 
98 REMl 234567898 1 234567898 1 234567898 1 234567898 ... 
188 REM START OF THE PROGRAM 
118 

The drawbacks to this scheme are potentially serious. The 
biggest drawback is that nowhere in the ML program may there appear 
the value o-f 0. That could be a real bother to get around in some 
situations. This limitation is due to the -fact that BASIC interprets 
the as a line terminator and any modi-fications or even SAVEing the 
program will cause havoc. The other drawback is that certain bytes 
will cause the listing o-f the program to appear strange or not appear 
at all. In fact, the value of 204 ($CC) will cause BASIC to choke 
upon listing it. It will give a SYNTAX? error. The program will run 
OK but will not be listable beyond that point. You may list the 
remainder of the program by typing "LIST 30-" for example if the 
syntax error stopped the listing prior to statement 30. This might be 
considered a sort of protection feature, as it will cause the 
opposition difficulty in listing your program (at least for awhile). 

The other place which is a likely candidate for storing the 
program within a BASIC program is at the end of the BASIC program. 
Here, the non-relocatability problem is present but the problem with 
having a in the ML is solved. If you can be sure you will never 
modify your BASIC program there is no relocatability problem. It only 
exists if you add to or delete characters in the BASIC program and the 
passenger program gets relocated. 

The best technique for adding the ML at the end differs from 
the REM technique explained above. First, find the end of your BASIC 
program. This is as simple as: PRINT PEEK(45) + PEEK(46) * 256. The 
value printed will be the end of BASIC and the start of variable 
storage. To add a passenger at the end you need to change the vector 
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at 45 and 46 to increase the program size by as much as you need for 
your ML component. H for example the end of your BASIC program is 
10000 and you wish to add a ML program of length 2000 » you would Key 
the following: POKE 46,12000/256: POKE 45, i2000-PEEK(45)*256. The 
next thing to do is to SAVE the program and immediately re-LOAD it. 
When the machine language is loaded into the reserved area it will not 
appear on the listing and it may have zeros or any other value. Now, 
any additions and deletions, SAVEing and re-LOADing of the BASIC 
program will Keep the ML intact. Referencing addresses within it from 
/our BASIC program is most easily accomplished by computing the 
address as a displacement from the end of the program. For example, 
if the entry point of the ML program is 500 bytes from the end of the 
program, your call to it would be SYS PEEK(45)+PEEK(46)*256-500. This 
way, no matter where the program gets shifted to by changes to the 
BASIC program, the SYS statement is always correct. 

Once you decide where you want your ML program to reside the 
problem is to get it there. There are a few options. You first need 
to find the address of the beginning of the machine language program, 
i.e. the address inside the BASIC program where the ML program will 
reside. This address must then be the address expressed in the 
operand of the EQU statement in the ML program which immediately 
precedes the first actual byte of ML to be generated. (Every EQU 
encountered resets the address of where succeeding ML gets stored). 

There is a loader sub-program which is a part of Develop-64. 
It is possible to use it to load the object file containing the ML 
into the area you have reserved in your BASIC program. It is also 
possible to use the POKE option of the assembler sub-program to 
directly POKE the ML into the reserved area. A third choice is to 
write a brief loader in BASIC as illustrated in the sample program in 
chapter 8. All of these options have one thing in common. They all 
involve having two BASIC programs in memory at the same time, the 
BASIC program you are trying to add the ML to and the program which is 
doing the adding. 

This is easily accomplished. First, load the BASIC program to 
be impregnated. Next, print the values of locations 43, 44, 45 and 46 
(e.g. ?PBEK(43), etc.). Write these down. Next, change the value 
stored at 44 to ijne greater than what is in 46. Now load the program 
which will do the loading of the ML and POKEing it into the reserved 
area of the first BASIC program. This program will now load after the 
end of your BASIC program. (This technique of changing the load 
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address o-f BASIC programs is use-ful also -for placing Develop-64 in a 
memory location which will not con-flict with a program which you wish 
to decode or debug). 

Running the second program* be it Develop-64 or a mini-loader* 
to load the object file or to assemble the source program and POKE out 
the ML will cause the ML to be placed into the space you have 
carefully reserved for it by the preceding operations. 

Once done* it is necessary to save the BASIC program with its 
embryo. To do this* you must restore the values of 43» 44* 45 and 46 
(POKE 43*...: POKE 44*...: etc.) with the values you recorded 
previously. Immediately follow this with a SAVE of the first program. 
The SAVE function of the Commodore 64 causes whatever is between the 
addresses pointed to by 43*44 and 45*46 to be saved. When you re-LOAD 
the BASIC program it should be carrying its ML child* ready to deliver 
(providing it was well conceived in the first place). 

The final way of getting ML into a BASIC program is the hardest 
and ugliest way available. This is to take the listing of the 
assembler and create a string of DATA statements with one decimal 
value for every byte of generated ML and to include a FOR NEXT loop 
reading every value and POKEing it into the desired memory locations. 
For programs which need to be self-documenting this may be the right 
solution. Anyone reading ^the BASIC program will have all the 
information needed to get the program to work. This is why so many 
magazines use this clumsy approach in their articles. 

The following approaches all assume that the ML will not be a 
part of some BASIC program. They all require some means of getting 
the ML into memory. For each case* the techniques for accomplishing 
this are the same. They are the same techniques as described above 
for getting the ML into a reserved space in a BASIC program* i.e. 
using Develop-64 to POKE the ML or to LOAD it from a created object 
file or with a mini-loader as in Chapter 8. For stand-alone ML 
programs* once they have been loaded by one of these means* they may 
be SAVEd by the "binary" SAVE feature of the SAVE sub-program of 
Develop-64. This will then allow them to be loaded with the normal 
L0AD"name"*8*i statement for disk or LOAD"name" for cassette. 

If you wish to do a binary save without Develop-64 in memory* 
the following routine will accomplish it for you. 
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10 TD=lsREM FOR DISK TD = 8 

20 POKE 781 ,TD: POKE780 , 1 : P0KE782,2: SYS 65466 

30 INPUT" START, END", 'A, B: INPUT" FILE NAME" ;A$ 

40 POKE780,PEEK<202)-11 SP0KE781 ,0 :P0KE782,2!SYS65469 

50 POKE780,251: P0KE252, A/256 : P0KE251 ,A-PEEK< 252) *256 

60 P0KE782,B/256:P0KE781 ,B-PEEK<782)*256 :SYS65496 

This program illustrates the ability to call kernal routines 
directly from BASIC. The A-reg, X-reg and Y-reg may be set up in 
locations 780-782 respectively before doing a SYS and the called 
routine will be entered with these registers pre-initialized. Upon 
returning from the called routine^ the above memory locations will 
contain the values of the registers upon exiting the routine. This 
can be a convenient way to communicate with your machine language 
program from BASIC. 



Before or after Basic 

The upper limit of the memory space which BASIC believes it 
has available for BASIC programs is maintained in an address vector at 
locations 55»56. At 52»53 is another vector which BASIC uses to set 
the highest memory address usable for string storage. The beginning 
address^ as mentioned above is pointed to by a vector at 43»44. 
BASIC starts storing strings at its highest available memory location 
and works back down. The free memory available in a BASIC program is 
the space between the high end of variable storage and the bottom of 
string storage. Strings are continually filling up the free memory 
gap as they are created by the program. Only when free memory is 
exhausted will BASIC clean up the string area for future string usage. 
This is what is known as "garbage collection" and what occasionally 
causes BASIC programs to pause for a while before continuing. The 
result of this system of string management is that no memory between 
the start of BASIC and the "top of memory" is free from possible 
destruction by the BASIC program. 

It is possible to save ML program segments in a space which 
will not be molested by BASIC programs if you modify the two vector 
sets at 51^52 and 55»56 so that they point to an address below the ML. 
Or you could modify the start of BASIC vector before loading the BASIC 
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program. In either caset BASIC will not even Know of the existence o-f 
that memory space and will not try to save anything there. 

Cassette Buffer $33C - $3FB (828 - 1019) 

There is a serious problem with putting. the ML in the cassette 
buffer if you don't have a disk drive. Whatever program you use to 
load the object file with will itself use the cassette buffer. And 
sot as it is reading the object file it is destroying the POKEd ML. 
If you have a diskette based system^ there is no problem. 

In sacred RAM $Cm - $CFFF (49152 - 53247) 

No protection from BASIC need be implemented when the program 
is up here. BASIC can't get to this area. It therefore makes an 
ideal place for ML programs. The only disadvantage is that the ML 
cannot be loaded along with the BASIC program. It must be loaded 
separately or by the BASIC program. 
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The 65 lO — A Da.±a. Processor 

Since Develop-64 is focused on the development of software 
through the creative use of machine language» it will be necessary to 
first understand the machine before learning its language. 

You're probably aware that there is something inside the case 
of the Commodore 64 which is Known as the 6510 microprocessor. This 
is the heart of the Commodore 64. It is a slightly modifided version 
of the 6502 which is the heart of the VIC 20, the Apple, the Atari, 
the PET, KIM, AIM, SYM, OSI and a few other microcomputers. It is a 
product of MOS Technology, a wholly owned subsidiary of Commodore 
Business Machines. 

The 6510 is an integrated circuit. That is, it is a single 
chip of silicon which has built into it, sort of like etched onto it, 
the electronic circuitry which connects thousands of microscopically 
small electronic components. These components are deposited on the 
silicon by some marvel of modern technology which is beyond the scope 
of this text. We won't go into how the electronics are created or how 
they function electronically. We are interested here in how to use 
this machine and how it fits into the environment of the Commodore 64 
personal computer. 

The piece of silicon called the 6510 is packaged in a piece of 
plastic or ceramic material about one inch by two inches. It has 40 
little bug-like legs called pins which connect the internal circuitry 
to the outside world. These pins plug into a circuit board which has 
other similar appearing chips of silicon, each with its own set of 
pins and its own internal characteristics, different from the 
characteristics of the 6510. Each of the chips has its own specific 
function and together they are combined, through their connecting pins 
and the circuit etched on the printed circuit board into which they 
are plugged, to make a microcomputer. 

This will become more and more clear as we describe what each 
of the component chips are for and how they work and how they 
communicate with one another. The description of the functional 
characteristics of the 6510 will completely define the processor from 
the programmer's standpoint. The electrical or electronic 
characteristics are of no interest to us as we have no need to 
understand the machine at that level. 

The 6510 is a data processor. It is a machine which performs 
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simple opera-tions o-f data manipulation under the control of a stored 
program. Both the data and the program are stored in memory devices 
which are integrated circuits electrically connected to the 6510. 
Programs are a special class of data and we will explain programs 
after we discuss data in a more general sense. 

Data is information. It can be the balance of your checking 
account or the grade your physics teacher gave you or the position of 
PAC-MAN on your video screen. Information! as it is stored inside the 
computer's memory devices is coded by a special set of simple rules. 
Memory devices are composed of thousands of cells> or storage 
locations^ where the data is kept. Each cell is composed of eight 
switches which can be turned either on or off. When the letter "A" is 
pressed on the keyboard of your Commodore 64^ some electronic 
circuitry will automatically create a pattern of eight switch settings 
which is uniquely identified as the pattern for the letter "A". This 
is the code for "A". Every character has its own code and it is 
different from all the other character's codes. There are only 256 
different unique codes which can be constructed from eight switch 
settings. There are therefore only 256 possible different characters 
which can be represented and stored in the memory chips of the 
Commodore-64. That's sufficient to handle A-Z^ e-9> all the special 
characters and the graphics characters. 

These switches are usually called "bits". Bit is short for 
binary digit. A digit may have le possible valueSf 0-9. A bit may 
have two possible values, 0-1. A bit which is turned on may be 
thought of as having the value of 1 and if it is off, it is a 0. So 
characters are represented as a string of eight bits with bit values 
of either or 1. The actual bit string for the letter "A" is 
01000001. The coding scheme used is an international standard called 
ASCII, which stands for American Standard Code for Information 
Interchange. 

The 6510's data link with the memory devices is called the data 
bus. This is nothing more than a set of eight lines, or electrical 
connections, between the memory chips and the 6510. When the 6510, 
under control of a program, wishes to either transfer data to or from 
a memory device, it sends an electrical signal on the R/W (Read/Write) 
line, telling the device which direction the data is to go. Since the 
memory device can store thousands of characters of data, it is 
necessary for the 6510 to tell it which storage location it wishes to 
get data from or send it to. It does this through another set of 
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electrical connections called the address bus. Every storage cell 
within the memory device has a unique address associated with it and 
when the signal comes to do a data transfer^ the memory device is 
designed to use the information sent on the address bus to know which 
cell is being selected. Each data cell holds eight bits oi 
information. This basic unit of data^ called a byte> is transferred 
all at once along the eight parallel electrical connections Known 
collectively as the data bus. 

The address bus is very similar to the data bus except it has 
sixteen parallel electrical connectors. Like the data bus* the address 
bus information is coded in binary. That iSf each of the sixteen 
lines may have only one of two possible states# a or a 1> presented 
to the devices as or +5 volts. The buses are connected directly to 
the pins which go inside the plastic package and connect to the 
internal microcircuitry on the silicon chips. The sixteen bit address 
bus allows for 65536 different addressable memory locations where data 
may be stored. 

Finally^ there is a control bus which contains lines which 
help to control the various chips in the Commodore 64. The R/W line 
mentioned above is one of the control signals. With the exception of 
the interrupt lines» discussed latere we don't need to know much about 
the control bus. 

Because the 6516 transfers and processes data eight bits at a 
timet it is Known as an eight bit parallel processor. Appendix goes 
into much more detail on the format of the data as it is stored in the 
memory devices. It is strongly recommended you read it. 

Memory devices come in two basic varieties as of this writing. 
ROM is read-only memory. When the power is turned off ROM doesn't 
lose its contents. ROM is a Kind of chip which may be "Read" but 
not written to. Its contents are "burned-in" at the factory. There 
is a similar Kind of memory device called a PROM which stands for 
Programmable ROM and it may be modified by a special piece of hardware 
called a PROM programmer. It must be erased by shining an intense 
ultraviolet light on its top surface for some prescribed length of 
time. 

Both of these differ from the other main Kind of memory device 
which is called RAM. RAM is badly misnamed. It should be called MOM 
for Modify able Memory or RAW for Read And Write. RAM stands for 
Random Access Memory^ which means you can extract data from it in any 
sequence you want. The same thing is true of all currently available 
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types of memory f including ROM, 

Anyway, the differences between RAM and ROM is that a program 
can write to RAM and change its contents and when the power is turned 
off the contents of RAM are lost, whereas ROM cannot be modified by 
any program under any circumstances and when the power is turned off, 
the contents of ROM are kept intact. In the Commodore 64, all of the 
operating system programs and the BASIC interpreter are in ROM. That 
is why you can run BASIC programs as soon as you turn the machine on, 
without having to load anything from tape or disk. 
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The Proc©»»or 

The 6516 microprocessor chip is a 6502 microprocessor with a 
twist. It executes exactly the same instruction set and has the same 
addressing modes as the 6502. It has some additional -features which 
render it more power-ful than the 6502 and we will look at these at the 
end of this chapter. In the meantime the following discussion will 
describe the 6562 and it will apply equally to the 6516> the 
microprocessor which controls the Commodore 64. 

The 6562 is a machine. Its moving parts are electrons and the 
only work it does is with data. It has some internal data storage 
which is identical in nature to the data storage in the memory devices 
to which it is attached through its external connectors. The internal 
storage is known as the machine's registers. The registers are eight 
bits wide and there are only seven of them. Each register has some 
special characteristics in the way the 6562 can utilize the data 
contained in it. The data processed by this machine is stored in the 
external memory and the registers. Processing consists of 
manipulating the data in some logical sequence which results in 
accomplishing some desired goal. The 6562 processor does its 
processing of data by interpreting and executing "instructions". 

Instructions are data. They are stored in the memory devices 
as eight bit bytes which are precoded ( programmed ) to make the 6562 
do some desired operation. The first byte of each instruction is 
called the Operation Code. The 6562 has pre-programmed circuitry 
built in to its microelectronics* etched onto its silicon chip, which 
can decode operation codes and figure out what it is supposed to do 
next based on the bit structure of the operation code. This logic 
comes with the 6562. The bright electronic engineers who designed the 
6562 at MOS Technology back in 1975 figured out how to make it 
interpret bit structures and to take whatever action each operation 
code was designed to make it do. They preplanned a set of data 
manipulation operations which they thought would be useful for a 
microprocessor to be able to do and then set about designing the 
machine and the operation codes so that those operations could be 
interpreted and performed. The way the processor is programmed by you 
the programmer is for you to place in the memory of the computer a 
sequence of instructions designed to make the 6562 do some presumably 
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useful task. You choose the instructions carefully from the set of 
available instructions which the 6502 can perform. You code these 
instructions in the language which the machine can understand> machine 
language. Each instruction has a specific bit pattern which is 
understood by the 6502 to mean perform some operation and use one of 
the 13 possible addressing modes. 

If you have an assembler you can write the 6502 instrucions in 
an understandable format which makes some sense to humans when they 
read it. The assembler will then convert the human understandable 
program into a machine undersandable sequence of bit patterns (bytes). 
ASM/EDT> which comes with Develop-64 is such a program for the 
Commodore 64. The next section tells you how to use it. In this 
section we will explore the 6502's architecture* its registers* its 
instruction set and its various addressing modes. First* the 
registers. 

The Program Comter 

The 1 6-bit Program Counter Register is actually two 8-bit 
registers* the PCL and PCH registers. These two registers are always 
used as a pair. The "PCH" stands for Program Counter High and "PCL" 
stands for Program Counter Low. Together* they are used by the 6502 
to form a sixteen bit address pointer. The 6502 moves the contents of 
these two registers to the address bus when it wants to fetch an 
instruction from some memory chip attached to the 6502. 

The Program Counter tells the 6502 where the next instruction to 
be executed is located in memory. When the computer is turned on* an 
initialization process occurs automatically. This process includes 
moving the data contained in addresses $FFFC and $FFFD directly into 
the PCL and PCH respectively. Addresses such as this which are stored 
in memory and point to the starting point of some other program are 
called "vectors". This is how the 6502 finds the address of its first 
instruction to be executed. So* every 6502 must have the address of 
the beginning of the first program to be executed prestored at $FFFC* 
$FFFD (65534*65535). This must obviously be in ROM. 

This initialization process occurs at power-on time and 
whenever the RESET button (available on some expansion chassis but not 
on the standard Commodore 64) is pushed. After each execution of an 
instruction by the 6502* the Program Counter is incremented to the 
next instruction* and so the program flow occurs. 
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Tht A-p»g 

The A-peg may be thought o-f as the Arithmetic register. It is 
o-ften called the Accumulator. Like all the registers^ it is a one- 
byte (8-bit) register. It is the place where arithmetic operations 
occur. Instructions like ADC ( Add with Carry ) and SBC ( Subtract 
with Carry ) cause data to be added to or subtracted ^rom the A 
register. The A reg may be loaded (new value brought into it) with an 
instruction such as LDA (Load the A-reg). Its contents may be stored 
out to some memory location with an instruction such as ST A (Store the 
A-reg). The address in memory where data is loaded-from and stored-to 
is speci'fied by -further addressing information provided to the 6502 by 
the program in a manner discussed in the next chapter. 

References to "STA" or "LDA" instructions are referring to the 
assembler language Bnglish-like mnemonic which gets translated into a 
machine language instruction recognizable by the 6502. There is a one 
for one correspondence between assembly language statements and 
machine language instructions. 

The X and Y registers 

There are two other "working" registers called the X and Y 
registers. These are also known as the index registers. These are all 
eight bit storage registers in the 6502 chip itself. The X and Y 
registers are used mostly in addressing functions as explained next 
chapter. The X and Y registers may both receive their contents (be 
loaded) from memory with instructions such as LDX and LDY (Load the X 
and Load the Y registers). They may be saved (stored) in memory with 
STX and STY instructions. They may also be incremented* decremented* 
and compared to data in external memory. 

Stack Pointer (SP) 

The second 256-byte block of memory ($0100-$01FF) is used by 
the 6502 in a special way. It is called the Stack. The Stack is a 
special storage block which is automatically utilized by certain 
instructions. Its primary reason for existence is to allbw subroutine 
"nesting" and to allow for the smooth handling of interrupts. 

Subroutines are program segments which can be executed by many 
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different programs. They are sub-programs> which are ^mped-to and 
returned-from. They save having to write commonly used program 
segments over and over again. The stack is the 6502'5 communication 
mechanism for remembering where a subroutine was "called" from. The 
JSR (Jump to Subroutine) instruction is explained in detail in Chapter 
5. Suffice it here to say that the JSR causes the program to Jump to a 
subroutine in such a way that the subroutine can return to the 
instruction after the JSR once it is done doing its processing. The 
6502 saves the return address on the stack when a JSR occurs. It 
pulls it off the stack when the RTS (return from Subroutine) occurs. 
The position of the next available stack location for recording return 
addresses is kept in the SP. The SP is initialized by the Commodore 
64 start-up program to the value of $FF at power-on and RESET time. 
The high-order byte of the stack address is always $01. This is fixed 
inside the 6502. The first time a JSR instruction is executed* the 
address of where to return to is pushed onto the stack at $01 FF and 
$0iFE. The SP is then decremented by two so that the new value of the 
SP is $01 FD. The subroutine called by the JSR may then call 
additional subroutines and the return addresses will be stored below 
the initial return address. There may be up to 128 levels of 
subroutines calling other subroutines. Each subroutine must have as 
its last instruction a RTS (return from subroutine) instruction which 
causes the 6502 to load the PC with the saved address from the stack 
and to increment the SP by two. Thus the return to the address from 
which the subroutine was called. 

Interrupts are caused by an electrical signal to the 6502 from 
the outside world. There are two interrupt lines attached to the pins 
of the 6502. One of them, the NMI line, will cause the 6502 to be 
interrupted regardless of what it is doing. This is called the Non- 
M askable Interrupt. This facility is provided so that hardware which 
has critical timing requirements may cause the 6502 to service them 
immediately. It is also provided as a means of unconditionally 
breaking into the processing of the machine if it is suspected that 
something has gone awry in a program and there is no other way to sieze 
control of the machine short of turning it off and turning it back on 
again. 

The other kind of interrupt is a maskable interrupt. A means 
exists to prevent the interrupt from being serviced. An interrupt may 
be "masked" (made so it can't be seen by the 6502) by the means of an 
"interrupt disable" bit in the Processor Status register. Maskable 



Iniidt The Commodm 64 



Page 7-5 



interrupts are those whose electrical connections are to the IRQ pin 
of the 6502. 

Both kinds oi interrupts are handled in about the same way by 
the 6502. The 6502 finishes processing the instruction which was in 
progress when the interrupt signal was recognized. It then saves the 
PC on the stack jasi as if a JSR had been executed. Additionallyt it 
saves the Processor Status Register on the stack and decrements the 
stack by three. It now loads the PC with the address found in 
location $FFFA and $FFAB for a NMI interrupt or $FFFE and $FFFF for a 
non-maskable interrupt. These locations must have been pre-programmed 
to contain the addresses of the programs which were written to service 
the interrupts. 

The interrupt processing routines must be exited via a RTI 
instruction (Return from Interrupt). This acts like the RTS 
instruction except that the Processor Status Register is reloaded from 
the stack before the PC is pulled from the stack. In this f ashion» 
the interrupted program may continue where it was interrupted and the 
status of the machine will be as it was at the time of interruption. 

The stack is also used by the PHA and PHP instructions to 
store the A-reg and the P-reg respectively in the stack. This is used 
to pass information to the subroutine. More information about these 
instructions may be found in Chapter 5. 

The Processor Status Register 

The Processor Status Register is a collection of eight bitSf 
sometimes called flagsf which reflect and control the operation of the 
6502. The bit assignment of the P-reg is: 



The Negative Bit 

"N" is the Negative-bit. It is turned on by the processor 
upon the execution of certain instructions. It reflects whether the 
result of an addition or subtraction is negative or not. A i value in 
the Negative bit indicates a negative result. This bit is set by load 
instructions and compare instructions too. See the chapter on the 
6502 instruction set for a complete explanation of each instruction 
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and how each a-F-fects the various status bits. 
The Overflow Bit 

The "V" bit is the overflow bit. It reflects whether or not 
"two's complement" overflow has resulted from a SBC (Subtract with 
Carry) instruction. It is also set by the BIT instruction. See the 
descriptions of those instructions for a more complete explanation. 

The BreaJK Bit 

The "B" bit is set by the processor when a BRK instruction is 
executed. The BRK instruction causes an interrupt to occur. It is a 
software interrupt^ used mostly in debugging machine language 
programs. The BRK interrupt is processed almost like a maskable 
interrupt. The same vector is used by the 6502 to find the address of 
the interrupt processing routine. The only way the processing 
routine can know if the interrupt was a software or hardware interrupt 
is by examining the "B" bit in the Processor Status Register which has 
been stored on the stack. The BRK is not maskable* but it uses the 
maskable interrupt vector. Also* the return address stored on the 
stack is the address of the BRK instruction plus two. 

The Decimal Mode Bit 

The "D" flag in the P-reg is a cue to the processor to do all 
ADC and SBC instructions in Decimal mode. In decimal mode» the data 
being added or subtracted will be assumed to be composed of two 
decimal digits per byte. Each digit is coded as a four-bit pattern 
having the range of values $0 - $9. The range of values which can be 
contained in a byte is 0-99 decimal. The name of this data type is 
Binary Coded Decimal (BCD). 

If the Decimal mode is clear* the ADC and SBC instructions 
will treat the data being added and subtracted as eight-bit binary 
values in the range 0-255. 

The "D" bit may be set and cleared by the program with SED and 
CLD instructions. 
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The Interrupt Disable bit 

The "I" flag is the interrupt-disable -flag. It may be set with 
the SEI instruction and cleared with the CLI instruction. When sett 
only non-maskable and software interrupts may occur. When Clear# all 
interrupts are enabled. 

The Zero bit 

The "Z" flag is set like the "N" flag, by arithmetic and load 
and compare instructions. If the result of these operations gives a 
zero result, the Z-flag is set. Otherwise it is cleared. 

The Carry bit 

The "C" flag is the Carry bit. It is set by addition, 
subtraction, shift and compare instructions as well as the specific 
SEC and CLC instructions. 

The N, V, Z and C bits may all be tested by conditional branch 
instructions. A full explanation of this facility is provided in the 
following chapters. 

The 6519 special characteristics 

The 65ie has a built-in Input/Output a/0) port. There are 
eight pins on the 6510 which may be connected to other pieces of 
hardware. Through these pins, numbered 0-7, data may be transfered one 
bit at a time. The connected external pieces, of hardware may 
transfer data directly to and from the memory of the computer. The 
data must be placed in memory location 1 for it to be transferred to 
the connected I/O device. This is the same address where the data 
passed by the external device to the 6510 will be found. 

The individual bits of location 1 may be programmed to be either 
input bits or output bits. This is accomplished by setting the 
corresponding bits of location 8 to reflect the direction of data 
transfer. A 1 in any given bit position of location will cause data 
to be transferred from the corresponding bit position of location 1 to 
the device attached to the corresponding I/O pin of the 6510. A in 
any given bit position of location will cause data to be transferred 
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from the device attached to the corresponding I/O pin of the 6510 to 
the corresponding bit position of location 1. Input bits are those 
which are turned on or off by the connected external device as it 
alters the voltage level of the electrical signal which appears at 
the I/O pin on the 65 ie. When the device puts a high voltage (+5 
volts) signal on the connecting pin and the data direction register is 
set as inputf the value 1 will appear in the corresponding bit 
position of memory location 1. A low signal (0 volts) will cause the 
value to be stored in the corresponding bit position of location 1. 

Output bits are those which are stored in location 1 by some 
program running on the 6510. The value of the bit to be transferred 
(either a 1 or a 0) gets translated to an electrical signal which 
appears on the l7o port pin of the 6510. The connected output device 
must be designed such that it understands a voltage signal of +5 volts 
to mean the value 1 and a voltage signal of volts to mean the value 
0. For data to be sent as desired* location must have a in the 
bit position of the data to be transferred from location 1 to the 
output device. 

Location is called the data direction register for the 6510's 
I/O port. Location i is called the I/O port. These registers do not 
exist on the 6502 and are what distinguish the two microprocessors. 

The Commodore 64 has a dedicated usage of the I/O port which 
will be examined in later chapters. 
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Processing 

The instructions within the program which control the processor 
cause it to either: 1) load data from memory into one o-f its internal 
registers or 2) to move data from one register to another or 3) to 
store data from one of the registers into memory or 4) to modify the 
data in one of the registers by some arithmetic operation or 5) to 
cause a change in the flow of the program. 

The 6516* as it decodes each instruction after having fetched 
it from memory* discovers three things about the instruction: 1) the 
number of bytes the instruction takes in memory; 2) the addressing 
mode of the instruction; 3) the operation to be performed. The 
operation code takes only one byte for every instruction but some 
instructions need to supply the processor additional information 
beyond the op-code. This is either address information or data. If » 
for ex ample » an instruction's purpose is to direct the processor to 
store the data contained in its A register into some location in 
memory* it needs to provide the 6510 the information as to where to 
store it. This could take one or two additional bytes depending on 
the addressing mode. 

Each operation code has coded into it the information as to 
what addressing mode should be used to accomplish the desired 
operation. The 65 Id has thirteen addressing modes. 



ABSOLUTE NODE - Absolute adressing requires a three byte instruction. 
The *ir5X is the op-code and the next two are the two bytes of address 
information. 

You recall that it takes two bytes ( sixteen bits ) to 
specify an address in the 6510 address space. This is because the 
address bus is si>(teen bits wide. The first byte of the two byte 
address is called the high-order byte or the most-significant b/te of 
the address. The second byte is the low-order or least significant 
byte. These are sometimes abbreviated the MSB and the LSB. The 6510* 
when it executes instructions with absolute addressing, simply fetches 
the next two bytes after the op-code and puts them on the address bus 
when it does the memory access operation specified by the op-code. 
The memory devices, which are attached to the address bus and the data 
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bus and the control bust are signaled by the R/W signal and read the 
address information of-f the address bus to select the memory location 
to either store data into or read data out of. If the R/W signal 
signifies Write, it will take the data from the data bus and store it 
into the memory location specified by the address on the address bus. 
If it is a Read signal, it will take the data already stored at the 
specified location and load it onto the data bus where the 6510 will 
find it and do whatever the op-code indicated should be done with it. 
In absolute mode, the address is stored after the op-code with the 
least significant byte immediately following the op-code and the most 
significant byte following that. Example: 

LDA$4521 
20Ce AD 21 45 

This is an example of both an assembly language statement on the 
first line and the machine language following it. The format is the 
same as that which appears on the screen when you run The Assembler. 
The assembly language mnemonic is LDA. It is the assembly language 
equivalent of the op-code. It means Load the A register. The 
Assembler, which converts assembly language into machine language, 
decodes the mnemonic and the following operand and produces the 
machine language which appears on the second line. The Assembler 
also produces a cassette or diskette file containing the machine 
language which The Loader can then read and store in the appropriate 
memory locations, where finally it can be executed as a program. 

For now, lets ^st look at the two statements as they appear 
here. The $4521 is called the operand field. It specifies to the 
6510 where the data to be loaded into the A register is to be found. 
The 29C0 is the address where the instruction is located. It was 
arbitrarily picked for this example. The second field, $AD, is the 
hex representation for the op-code. Following the op-code is $21, the 
second byte of the address specfied in the assembly statement above. 
It is followed by $45, the first byte of the address. This is the 
order the 6510 expects to find addresses. The 6510 processes this 
instruction when its Program Counter has the value of $20C0. It 
fetches the op-code at that address and decodes it and executes it in 
the following sequence: 1) It determines from the op-code of $AD that 
this is an instruction to cause the A register to be loaded from a 
location whose address it will find immediately after the op-code. 2) 
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It -fetches the next byte a-fter the op-codet $21» and puts it on the 
least significant byte o-f the address bus. 3) It -fetches the next 
byte* $45f and puts it on the most significant byte o-f the address 
bus. 4) It sets the R/W line to R. 5) It waits for the memory device 
to get the specified data and put it on the data bus. 6) It reads 
the data from the data bus and puts it in its A register. 6. It 
increases the PCHtPCL register pair by 3 so that it now points to the 
next op-code. 

This is a complete instruction cycle. 

ZBRO PAGB NOI^ - If you take the sixteen bit address bus and split it 
in halff the first eight bits could be thought of as a "page number" 
and the second eight bits could then represent the address (from - 
255) within that page. This would mean that there are 256 possible 
pages» each with 256 memory locations. Zero Page would then represent 
all memory locations from $0000 to $00FF (0 to 255). Page one would 
immediately follow, containing the addresses $0100 to $0 IFF (256 to 
511). 

These are two pages which have special significance for the 
6510. Page zero addresses may be specified with certain machine 
language instructions which are specifically coded as Zero Page 
addressing mode. Page one is designated the stack page as explained 
in the previous chapter. More about that later. The designers of the 
6510 decided it would be good to have an addressing mode which allowed 
the 6510 to execute instructions faster and would consume less memory. 
The Zero Page addressing mode was part of the solution. The 
addressing mode is specified as a part of the op-code. In decoding 
the op-code» the 6510, upon determining that the addressing mode is 
ZP, then knows that the address to be accessed is in zero page. It 
therefore has only to load one more byte of addressing data, the low- 
order or least-significant portion of the address. The high-order 
half of the address will be forced to $00 by the 6510. Therefore, 
Zero Page instructions are only two tytes long; the op-code and the 
address within zero page where the data is to be stored or found. 
Example: 

STA B$7C 
20C0 85 7C 

The left-arrow is the code to the assembler that this is a Zero 
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Page instruction. The address speci-fied by the operand is iee7C. 
This is a Store the A-reg instruction. Op-code $85 causes the 
contents of the A-reg to be stored into the specified zero page memory 
location ($ee7C in this example). 



IN MEDIATE MODE - Some instructions may direct the processor to find 
the needed data immediately after the op-code rather than having to go 
to some specified address to find it. These are two-byte 
instructionsf one for the op-codei one for the data. They execute 
even faster than the zero page instructions because the 6510 needn't 
put anything on the address bus or wait for another fetch cycle to 
complete before it gets the data it needs. Example: 

SBC #25 
2ece E9 19 

Note here that the operand field has a preceeding the data 
value. This is the code to The Assembler that this is an Immediate 
Mode instruction. Note also that no preceeds the value 25. The 
Assembler recognizes four data types» decimal^ hexadecimal, symbolic 
labels and ASCII character. Hex numbers are indicated by a leading 
"$% ASCII characters by a " ' " decimal numbers by a first character 
of 0-9, and symbolic labels everything else. In every case, The 
Assembler will convert the specified data value into binary (or hex if 
you wish, the shorthand notation for binary) which is all the 6510 can 
ultimately understand. The second line displays the machine language 
in the same format as before. The first field is the address in hex 
where the instruction will reside, followed by the op-code in hex, 
followed by the data value in hex also. Check for yourself that $19 
is the same thing as decimal 25. 

The Assembler has an option you may select each time it is run 
to print the addresses and generated machine language in either 
decimal or hex. The file which is created for loading by The Loader 
will always contain hexadecimal. 

SBC stands for Subtract with Carry. It is an instruction to 
Subtract the specified data value from the contents of the A-reg and 
to store the result back in the A-reg. 

One further note: Most instructions may be specified with a 
variety of addressing modes. The Assembler examines the operand field 
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to determir^ which addressing mode is being speci-fied. It then 
generates the proper machine language op-code to indicate both the 
operation to be performed and the addressing mode. As an example^ 
"SBC %^¥¥3** is an absolute mode version oi the SBC instruction and the 
op-code for it is $BD as compared with $B9 as in the above example. 
Appendix A contains a list of all instructions and their allowable 
addressing modes. 

INPUBD NODB - The implied mode of addressing is the fastest executing 
and the shortest instruction length. In implied modet only the 
internal registers of the 6510 are addressed. Beyond the op-code> no 
more information is required* so implied mode only takes one byte. 
Examples: 

TAX 
e23F AA 

TYA 
6240 98 

TAX causes the contents of the A-reg to be transferred to the 
X-reg. TYA causes the contents of the Y-reg to be transferred to the 
A-reg. 

A-RBG NODB - The A-reg is sometimes called the Accumulator. This is a 
carry over from more primitive times. In any event* Commodore and MOS 
Technology choose to refer to the A-reg Mode as the Accumulator Mode. 
Call it what you like* it is really an implied mode. In A-reg Mode* 
only the A-reg and the Carry* Negative and Zero bits of the Status 
register are affected. The A-reg mode instructions are valid only for 
the "shift" instructions* ASL* ROL* LSR and ROR. For more information 
on shift instructions* see the next chapter. Examples: 

ROR A 
e21A 6A 

ASL A 
e21B eA 

RELATIVE MODE - There are three classes of instructions which cause 
the flow of the program to change. The JMP and JSR instructions are 
explained in the following chapter. All three types of instructions 
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accomplish program flow changes in the same general way. They cause 
the Program Counter register to be modified. The PC is the register 
pair which points to where the next instruction is to be found in 
memory. It is automatically incremented by the instruction length 
each time an instruction is executed. The instructions which modify 
the PC cause the program to "take a branch". That ist the next 
instruction to be executed will not be the one immediately following. 
It will be found at an address which is determined by the addressing 
data supplied by the branching instruction. 

The adddressing information supplied by the "relative mode" 
instructions is a single byte of data which follows the op-code and 
which is added to the value of the PC to determine the new PC value. 
The branch is to an address which is the specified number of bytes 
away from the branch instruction itself. The address information is 
called the relative displacement. 

These instructions only modify the PC sometimes. They are 
called conditional branch instructions. They test the status of a bit 
in the Processor Status Register and the 6510 decides at the time the 
instruction is executed whether to Branch ( modify the PC ) or not* 
based upon the value of the bit being tested. Example: 



NOTA 



CMP 




8308 


C9 


41 


BNE 


NOTA 


8302 


D0 


03 


JMP 


PROCESSA 


0305 


4C 


7D 04 


CMP 




0308 


C9 


42 


BEQ 


PROCESSB 


030 A 


F0 


CC 



This is a short program segment which first compares the 
contents of the A-reg with the character "A". The format of the 
program listing is the same as that which is produced by The Assembler 
when printer output is employed. Note the Immediate symbolt "#" and 
the "character" symbol " ' ". The function of the compare instruction 
is to set the Zero bit in the status register if the compare proves to 
be a match. Otherwise the Zero bit is cleared. 

The instruction after the compare is the conditional branch 
instruction. It is a Branch Not Equal instruction. If the result of 
the compare results in the zero flag being sett the branch will not 
happen and the JMP instruction following the BNE will be executed next 
as usual. If not» the next instruction to be executed will be the 
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instruction at $0308. 

Here you see one O'f the great advantages oi having an 
assembler which allows you to use labels to identify program 
locations. YoUf the programmer can use meaning-ful symbols to refer to 
some address in memory. You write the assembly language program 
without regard to the actual addresses of each instruction in the 
program. If you want to cause the program to branch to some 
instruction somewhere in the program^ you put a label in English on 
the instruction and The Assembler automatically computes the address 
of the instruction for you. In this case the symbolic label is 
"NOTA". 

Assemblers which permit this capability are called symbolic 
assemblers. Single-line assemblers such as is incorporated in 64MON 
are severely limited by their lacK of this feature. 

The generated machine language is particularly interesting 
here. The byte following the BNE op-code is a "$93". Relative 
addresssing means that the value found in the byte after the op-code 
is the number to be added to the PC to find the address to be Branched 
to. That iSf if the 6516 finds that the status bit being tested by 
the Branch instruction indicates a Branch should be taken* it then 
adds the value found in the byte after the op-code to the PC. (It has 
already incremented the PC by two before testing the status bit). The 
Assembler automatically computes the difference between the address of 
the instruction following the BNE instruction and the beginning of the 
instruction NOTA. In this case the amount of ad^stment is three 
bytes. NOTA occurs three bytes past the address of the JMP 
instruction. It is possible to specify a conditional branch forward 
by as much as 127 bytes or backwards as much as 128 bytes. When 
backward branches are specified* the displacement value in the byte 
after the op-code must contain a negative number. 

We mentioned earlier that a single byte may represent the 
decimal range of 0-255. For special situations such as the relative 
branch instructions it is convectenient to allow the 256 possible values 
of the eight bits to represent a range of numbers from -128 to +127. 
To accomodate this need* a system was devised to indicate negative 
numbers. It is called the two's complement system. It seems a little 
strange at first* but with a little practice it, too* can be mastered. 

Negative one is represented as $FF. Negative two is 
represented as $FE (or 254 in regular decimal). You can convert a 
number to its negative by subtracting it from 256 then converting the 
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result to hex. Forexamplet the hex representation of -6 is 256- 
6=256=$FA. This system is popular with computer designers because it 
makes arithmetic easy. Note that 256 in hex is >0189. Subtracting 
six -from $8180 gives $FA. But $8188 takes two bytes. The maximum 
value O'f one byte is $FF. H we add one to $FF we get $88 with a 
carry o-f one. And with $FF representing -1 it is very nice that when 
we add 1 to -1 we get 8. Likewise when we add 1 to minus 2 ($FE) we 
get $FF (-1). Another advantage of this system is that all the 
negative numbers have the high-order bit on (leftmost bit value = i). 
The positive numbers are $88 (8888 8888) to $7F (8111 ilil) and the 
negative numbers are $88 (1888 8888) to $FF (11111111). It is not 
coincidental that the N-flag (Negative bit of the Status Register) is 
set every time any arithmetic operation results in a value with the 
high-order bit on. 

The Assembler will automatically convert relative branch 
displacements to the proper value for both forward and backward 
branches. And The Assembler will also allow the expression of 
negative numbers in the more familiar format of decimal numbers ( -34# 
-122» etc. ) and do the conversion to the two's complement value for 
you. In debugging » however > it sometimes comes in handy to be able to 
do the conversion yourself and is worth knowing how to do. 

INDEXED NODES - The X register and the Y register are sometimes called 
the index registers. This is because they are used as indexes to 
data. That is* the relative position of data in a string may be 
addressed by specifying a base or starting address of the string plus 
some position index to indicate which data element in the string is 
being addressed. The X and Y registers can be used with certain 
instructions to be the position index. The instruction specifies a 
base address and an index register. The 6518 adds the value of the 
index register to the base address to get the effective address of the 
data to be accessed. This is a very useful capability. The following 
program segment illustrates the use of indexed addressing to move a 
string of data from one place in memory to another: 
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STRIN61 
STRING2 



EQU $8488 
EQU $8488 
EQU $2888 
LDX #18 
LDA STRING1,X 
STA STRING2,X 
DEX 

BPL LOOP 



8488 
8488 
2888 
2888 
2882 
2885 
2888 
2889 



LOOP 



A2 8A 
BD 88 84 
9D 88 84 
CA 

18 F7 



Several new things are presented in this program segment. The 
first two statements cause The Assembler to equate a symbolic label 
with a specific address in memory. For every subsequent reference to 
the label being EQUated (STRING! in this example) The Assembler will 
Know that the address being referred to is the one in the operand 
field of the EQU statement ($0488). Note the generated machine 
language which follows the statement; LOOP LDA STRING1,X. The 
address $8488 is automatically generated by The Assembler ( in the 
required low-order-byte-first format ). 

The third EQUate tells The Assembler what value to assign to the 
Location Counter. The Location Counter is The Assembler's equivalent 
of the 65 1 8 's Program Counter. The difference is that the Program 
Counter is an actual hardware register contained on the 6518 chip. 
The Location Counter is The Assembler's symbolic equivalent of the PC. 
The address printed on the machine language line after each assembly 
instruction is the value of the Location Counter for each instruction. 
It shows us where the generated machine language will be in memory 
when The Loader finally loads the program into memory. Every EQUate 
statement sets the Location Counter to the address expressed in the 
operand field of the statement. 

The LDX instruction loads the X-reg with the value 18. The 
next two instructions illustrate the indexed addressing mode. The 
first instruction loads the A-reg with a byte of data found at address 
$488A. The address specified in the LDA instruction is $8488. The 
contents of the X-reg are added to the specified address by the 6518 
before putting the address on the address bus. Since the X-reg has 
Just been loaded with the value 18> the address where the data will 
come from to be loaded into the A-reg is $8488 + $888A or $848A. 

The next instruction turns right around and stores that same 
data back in memory at the address $848A. So we now have three copies 
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oi the same byte of data. One copy in $e4eA, one in $e48A and one in 
the A-reg. The next instruction, DEX, causes the X-reg to be 
DBcreased or decremented by i. Since it had the value oi iO coming 
into this instruction, after the instruction is executed, it will have 
the value of 9. The next instruction, BPL LOOP, will conditionally 
branch to the instruction which has the label LOOP. Note this is a 
backward branch of 9 bytes. The generated machine language value of 
how far to branch is $F7. Remember about negative branch 
displacements? 256 - 9 = 247. 247 / 16 = 15 with a remainder of 7. 
Hence the hex value of -9 = $F7. Conveniently, The Assembler made 
that calculation for us. 

The BPL instruction tests the Negative bit of the Status 
Register. BPL stands for Branch if PLus. The Negative bit is 
affected by every execution of a DEX instruction (and many other 
instructions as well). If the X-reg was zero before the execution of 
the DEX, the result of the DEX would be a negative number in the X- 
reg. The Negative bit would be set to one. The BPL tests the 
negative bit. If it is not a one (not negative) the X-reg must still 
be positive or zero after having been decremented by the DEX. 

The branch will be taken back up to LOOP. The A-reg will now 
be loaded from address $9409 and stored into address «e489. The X-reg 
will be decremented again and tested to see if it went negative yet. 
Once again, it is positive (it has the value 8 now). The branch will 
be taken back up to LOOP, the same process will occur once again, this 
time moving a byte from $0408 to $6488. Once again, the X-reg will be 
decremented and tested and found not-negative. The loop will be 
executed a total of 11 times, with the X-reg varying from iO to 0, the 
address of data being loaded into the A-reg varying from $64eA to 
$0400, the address of where data is moved to varying from $048A to 
$0480. 

This is the process by which a wide variety of repetitive 
operations are performed upon data with the 6510. This is a very 
standard loop. If it still seems mysterious to you read it over again 
and when we get to the section on actually using The Assembler / 
Editor, The Loader, The Monitor, and The Decoder, we will create an 
actual program which does just this process. We will execute the 
program one step at a time with The Monitor, watching how everything 
works and seeing the registers and the memory locations changing as we 
go through the program. 
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There are four modes of addressing which are called indexed. 
Both the X-reg and the Y-reg may be used in indexed instructions and 
both may be used in combination with absoulte and Zero Page modes. 
Like the absolute and ZP addressing modes> the absolute^X and ZP>X 
instructions take three and two bytes respectively. The Y-reg and the 
X-reg -function identically in their respective modes. The four 
indexed modes then are: abs,X ; ZP»X ; abs»Y ; ZP»Y . 

INDIRBCT HODE - There is only one instruction which uses the simple 
indirect mode of addressing. This is the JMP (addr) instruction. The 
parenthesis around the absolute address signifies indirect. What 
happens with the indirect jump is the following: 1) The 6516 gets an 
address from the two bytes immediately following the op-code. Rather 
than load the PC with this value directly, it fetches an address from 
the specified memory location and the memory location immediately 
following it. This is the address which it loads into the PC. Thus a 
change in the program flow is caused. 

To state this another way, for the JMP indirect to work as 
desired, there must be an address pre-stored somewhere in memory. The 
JMP instruction must tell the 6510 where that address is located in 
memory. The 6510 will then load its PC with the address stored 
therein. Such a prestored address is called a vector. BASIC has 
several vectors saved in the first few pages of memory which point to 
various processing programs. 

Vectors are convenient ways of allowing the flexible design 
of operating systems such that new versions and updates to the 
operating system can be compatible with the old versions. Programs 
which need to use the various routines pointed to by vectors will not 
need to be changed because of a different location of the routine in 
the new version. The vector will be the only thing which will have to 
be modified to allow compatibility. 

(INDIRBCT)»Y - This mode is somewhat similar tc/the indirect mode 
discussed above. The above instruction was applicable only to the JMP 
instruction. This mode is applicable to various data access and 
manipulation instructions. These instructions are two byte 
instructions. The second byte of the instruction specifies an address 
in zero page. Like with the previous mode, there must be an address 
stored at the specified location. The big difference here is that the 
Y-reg is added to the address found in zero page to give the 6510 the 
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eventual address of where the data should come -from or go to. 
The (Indir),Y mode is actually used exactly like the addr»Y mode. It 
is useful for doing loops. The only difference is that the base 
address of the loop is stored in Zero Page rather than specified 
directly by the instruction. The instruction then specifies the Zero 
Page location of the base address. This is a very handy way to 
program a subroutine which is used at different times and called from 
different places in the mainline program to do the same general tasK 
but with differing sets of data. The base address of the data to be 
manipulated by the subroutine must be appropriately set up in Zero 
Page each time ^st before the subroutine is called. The subroutine 
itself never has to change anything. It uses the zero page vector to 
get the data it's been called to use. Example: 



Here» the subroutine* SUBRA, is designed to do a general 
purpose move of data from some location in memory to some other 
location. The number of bytes to be moved is found in location $0640. 
The location of where to move the data from is found in $007C and 
$O07D. The address of where to move it to is found in locations 
$0080 and $0081. The calling program must set those locations up with 
the appropriate values for the subroutine to function as desired. 
Note that no left arrow is required for the (indBxed)fY mode even 
though the specified address is always in Zero Page. 

aNDIRECTfX) - This is the last and probably the least useful 
addressing mode provided with the 6510. You may have guessed that it 
15 similar to the previous mode. It would be a lot more useful if it 
were identical except for the register used. Unfortunately, it isn't. 
You should notice that the X is inside the parenthesis, whereas in the 
previous mode, the Y is outside the parenthesis. This is reflective 
of the important dis-tinction. The parenthesis indicate the 
"indirection". In the previous example, the Y-reg was added to the 
address found in Zero Page, and the result of that addition provided 



SUBRA LDY 
LOOPA LDA 



B$40 

<$7C),Y 
($80) ,Y 



STA 
DEY 
BPL 
RTS 



LOOPA 
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the address oi the desired data. Here» the X-reg is added to the 
specified address to find where in Zero Page the vector resides. The 
X-reg is there-fore an index to a table of vectors stored in Zero Page. 
This mode is not useful* therefore^ in the same way that the other one 
is. It might find some use in unusual situations where there is a 
need to have a list of addresses of data bytes and a routine is needed 
to process the various data bytes. Such a routine would step through 
the list* an address (two bytes) at a time» using the X-reg to bump 
thru the list and to point to the appropriate address at which the 
data will ultimately be found. Perhaps you can find some better use 
of this mode. 



These last four chapters have been fairly packed with information 
on the workings of the 6510. It will be necessary to write some 
programs and to examine the programs of others to get a comfortable 
feeling about the use of the various instructions and addressing 
modes. The next chapter will present every available instruction on 
the 6510. After completing it» you will be able to start to take 
control of your computer by writing powerful machine language 
programs. 
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65 10 — Ins"tnuc-tion Se± 

There are 56 separate instructions which the 6510 has been 
designed to execute. There are also two "pseudo-op instructions" 
which are not a part of the 6510 's instruction set but which The 
Assembler understands. 

There are 13 addressing modes. Some instructions are limited 
to a single addressing mode> others are capable of utilizing up to 
eight. Most of the instructions are quite simple functionallyt and 
require only a sentence or two to describe their characteristics. We 
will cover these first. 

Register-only instn^tions 

TAX - Transfer the contents of the A-reg to the X-reg. Only the 
receiving register is modified. The Zero bit of the Status Register 
is set (made to have the value 1) if the value transferred is zerot 
otherwise it is cleared (made to have the value 0). The Negative bit 
of the Processor Status Register is set if the high-order bit of the 
value transferred is on (value i)f else it is cleared. 

TAY - Transfer A-reg to Y-reg. The A-reg is stored into the Y-reg. 
The same notes apply as with TAX. 

TYA - Transfer Y-reg to A-reg. The Y-reg is stored into the A-reg, 
The same notes apply as with TAX. 

TXA - Transfer X-reg to A-reg. The X-reg is stored into the A-reg. 
The same notes apply as with TAX. 

TXS - Transfer X-reg to Stack Pointer. The X-reg is stored into the 
Stack Pointer. No status bits are affected. This is the only way of 
initializing the Stack Pointer. 

TSX - Transfer Stack Pointer to X-reg. The Stack Pointer is stored 
into the X-reg. The same notes apply as with TAX. 

- SEt the Carry bit. The Carry bit is set to value 1. 
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CLC - CLear the Carry bit. The Carry bit is cleared. 

SBD - SEt the Decimal Mode bit. The Decimal Mode bit is set to value 
1. The Decimal mode of arithmetic is enabled. 

CLD - CLear the Decimal Mode bit. The Decimal mode of operation is 
disabled. The Decimal Mode bit is cleared. 

CLV - CLear the oVerflow bit. The overflow bit in the Processor 
Status Register is cleared. 

CLI - CLear the Interrupt disable bit. The Interrupt disable bit in 
the Processor Status Register is cleared » allowing interrupts to 
occur. 

SEX - SEt the Interrupt Disable bit. The Interrupt disable bit in the 
Processor Status register is set to i» causing all interrupts to be 
masked (disabled) until the Interrupt disable bit is cleared with a 
CLI. 

DBX - DEcrement the X-reg. The value contained in the X-reg is 
decreased by 1. If the resulting value in the X-reg is zero* the Zero 
bit is set in the P. If it is not zero* the zero bit is cleared. If 
the resulting value in the X-reg has the high-order bit ont the 
Negative bit in the Processor Status Register is set. Otherwise the 
Negative bit will be cleared. Note that register values of 0-127 will 
have a clear high-order bit and values of 128-255 will have the bit 
set. 

DEY - DEcrement the Y-reg. The value of the Y-reg is decreased by 1. 
The Zero and Negative bits are affected as with the DEX instruction. 

INX - INcrement the X-reg. The value of the X-reg is increased by 1. 
The Zero and Negative bits are affected as with the DEX instruction. 

INY - INcrement the Y-reg. The value of the Y-reg is increased by i. 
The Zero and Negative bits are affected as with the DEX instruction. 
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Nemcry accessir^ instructions 



INC -INCrement memory. The value of a byte located in memory is 
increased by i. The Zero and Negative bits are a-f-fected as with the 
DEX instruction. Only ZP; ZPtX; ABS; ABSfX modes are valid. 

DEC - DECrement memory. The value of a byte located in memory is 
decreased by i. The same comments as apply for INC. 

LDA - LoaD the A-reg. The contents of a memory location are 
transferred to the A-reg. The Zero and Negative bits are affected as 
with the TAX instruction. Valid addressing modes are: Immediate; ZP; 
ZP,X; Absolute; Absolute,X; Absolute,Y; (Indirect^X); (Indirect,?) 

LDX - LoaD the X-reg. The contents of a memory location are transferred 
to the X-reg. The Zero and Negative bits are affected as with the TAX 
instruction. Abst ZP and ZPfY addressing modes are valid. 

LDY - LoaD the Y-reg. The contents of a memory location are 
transferred to the Y-reg. The Zero and Negative bits are affected as 
with the TAX instruction. Abs, ZP and ZPfX addressing modes are 
valid. 

STA - STore the A-reg. The contents of the A-reg are transferred to a 
memory location. No registers or status bits are affected. Valid 
addressing modes are: ZP; ZP>X; Absolute; AbsolutCfX; Absolute,Y; 
(IndirectrX); (Indirect,Y) 

STX - STore the X-reg. The contents of the X-reg are transferred to a 
memory location. No status bits or registers are affected. Abs, ZP 
and ZP>Y addressing modes are valid. 

STY - STore the Y-reg. The contents of the Y-reg are transferred to a 
memory location. No status bits or registers are affected. Abs, ZP 
and ZP,X addressing modes are valid. 
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BCC - Branch Carry Clear. The program counter will be modified by the 
amount of the specified displacement if and only if the Carry bit is 
clear (0). Forward branches may occur up to 128 bytes from the 
address of the first byte following the branch instruction. Backward 
branches may occur up to 127 bytes from the same address. No other 
registers other than the PC are affected. Only Relative addressing 
mode is valid. 

BCS - Branch Carry Set. The program counter will be modified by the 
amount of the specified displacement if and only if the Carry bit is 
set (1). Same comments as for the BCC instruction. 

BEQl - Branch EQual. The program counter will be modified by the 
amount of the specified displacement if and only if the Zero bit is 
set (1). Same comments as for the BCC instruction. 

BNB - Branch Not Equal. The program counter will be modified by the 
amount of the specified displacement if and only if the Zero bit is 
clear (0). Same comments as for the BCC instruction. 

BNI - Branch Minus. The program counter will be modified by the 
amount of the specified displacement if and only if the Minus bit is 
set (i). Same comments as for the BCC instruction. 

BPL - Branch Plus. The program counter will be modified by the amount 
of the specified displacement if and only if the Minus bit is clear 
(0). Same comments as for the BCC instruction. 

BVC - Branch overflow Clear. The program counter will be modified by 
the amount of the specified displacement if and only if the Overflow 
bit IS clear (0). Same comments as for the BCC instruction. 

BVS - Branch overflow Set. The program counter will be modified by 
the amount of the specified displacement if and only if the Overflow 
bit is set (1). Same comments as for the BCC instruction. 
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Jump instructions 

JNP - JuMP. The PC is loaded with the specified addresst causing a 
change in the flow of the program. Both Absolute and Indirect 
addressing modes are valid. 

JSR - Jump to SubRoutine. The PC is first incremented by 2. The new 
PC is then stored on the stack. The PCH is stored in the stack 
location addressed by the Stack Pointer. The Stack Pointer is 
decremented and the PCL is then stored in the new stack location as 
addressed by the SP. The SP is decremented a second time and the 
address specified by the JSR instruction is loaded into the PC> 
causing a ^mp to the specified subroutine location. Note that the 
address stored on the stack is not what might be expected. The 
address is of the third byte of the JSR instruction, not the address 
of the next sequential instruction after the JSR. The RTS 
instruction, which causes a return from the subroutine, compensates 
for this anomaly. Generally, the casual programmer needn't worry 
about the mechanics of stack operations as long as she always has a 
RTS for every JSR. However, advanced machine language programmers are 
fond of direct stack manipulation techniques, especially for passing 
arguments to subroutines. 

RTS - ReTurn from Subroutine. The Stack Pointer is first incremented. 
The PCL is loaded from the stack address pointed to by the Stack 
Pointer. The SP is then incremented again and the PCH is loaded from 
the stack. The PC is incremented to compensate for the JSR operation 
of putting the address of the third byte of the JSR on the stack 
instead of the address of the next instruction. Now the PC has the 
address of the instruction immediately following the most recent JSR 
instruction. The program flow is thus returned to the mainline 
program from the subroutine. 

RTI - ReTurn from Interrupt. This instruction reverses the process 
which occurs when an interrupt occurs. The Processor Status Register 
is retrieved from the stack where the interrupt caused it to be 
stored. The PCH and PCL are then reloaded from the stack where they 
too were stored as a part of the 65ie's interrupt processing. The 
return to the point of interruption is thus complete, with the 
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Processor Status Register having the same value it had at the time o-f 
interruption. 

BRK - BReaK. Interrupt processing is caused to occur. The address o-f 
the next byte following the BRK instruction is saved on the stack. 
The Break bit is turned on in the Processor Status Register which is 
then saved on the stack. The PC is loaded with the address -found at 
memory location $FFFE and $FFFF. 



Stack Push & Pull Instructions 



PHA - PusH the A-reg. The A-reg is stored on the stack at the address 
pointed to by the SP. The SP is then decremented. All PHA's should 
generally be matched with a following PLA. 

PLA - PuLl the A-reg. The SP is incremented, then the A-reg is loaded 
•from the stack location pointed to by the new value of the SP. 

PHP - PusH the P-reg. The Processor Status register is pushed onto 
the stack in the same fashion the A-reg is with the PHA. 

PLP - PuLl the P-reg. The Processor Status register is pulled off 
the stack in the same fashion the A-reg is with the PLA instruction. 

Pseudo-op Instructions 



BYT This is not really an instruction in the instruction set of the 
6516. It is an instruction which The Assembler recognizes and 
interprets to mean, generate machine language data. The operand field 
of the BYT instruction can express several types of data which The 
Assembler will understand. 

If the first character of the BYT is a " $ % the following 
characters must be hex characters, i.e. A-F. The Assembler will 
handle a string of hex characters up to 75 characters in length. It 
will generate a data string with two nybbles (a half byte - 4 bits) 
per byte, inserting a $0 in the high-order nybble of the high-order 
byte if there are an odd number of characters specified. 
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If the first character is a " The Assembler will create a 
data string with as many bytes as there are characters following the " 
' The values of the generated bytes will be the ASCII values of 
the corresponding characters. 

If the first character of the operand is a ">" or "<" the 
remainder of the operand field will be interpreted as an address 
expression and the generated byte will be either the high-order byte 
of the address or the low-order byte depending on whether the first 
character is s ">" or a "<". Any other first character will cause the 
operand field to be interpreted as an address expression and the 
assembler will compute a two-byte address in the low-order-byte-first 
format. Address expressions are covered fully in the chapter on 
writing assembly language programs. 

EQU - BQUate. This pseudo-op does not generate any data which gets 
stored into memory by The Loader. It is an instruction to The 
Assembler to set the Location Counter and to cause the label in the 
label field to be assigned to the address which is expressed in the 
operand field. 



Shift Instructions 



ASL - Arithmetic Shift Left. The contents of the A-reg or of a memory 
location are shifted one bit position to the left. The low-order bit 
position is forced to value zero. The high-order bit is shifted into 
the Carry bit. The Negative bit is set if the bit shifted into the 
high-order bit position is a 1. It is cleared if it is a zero. The 
Zero bit is set if the resulting value of the shifted byte is zero, 
cleared if it is not. 

As an example, if the A-reg has the value $CC ( liee HOC ), 
after the "ASL A" instruction has been executed, it will have the 
value $98 ( 1001 1000 ) and the carry bit will be set. If the A-reg 
has the value of $5F ( 0101 1111 ) the "ASL A" will cause it to become 
$BE ( 1011 1110 ) and the carry bit will be clear. Note that each left 
shift causes the A-reg to double in value as long as the high order 
bit is not a one before the shift. Shifting left is a convenient way 
of multiplying a value by two. Using ASL in combination with ROL, a 
multiple precision shift may be effected. See the description of the 
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ROL instruction. Valid addressing modes are: Accumulator; ZP ; ZPtX ; 
ABS ; ABStX. 

ROL - Rotate Left. The A-reg or a byte in memory may be shifted one 
bit to the left. The high-order bit gets shifted into the Carry bit. 
The low-order bit recieves the previous contents of the Carry bit. 
The same addressing modes apply as for the ASL instruction. 

A multiple precision bit shift is one where a string of bytes 
is treated like one long bit pattern and the shift causes the bits 
which come out of the high-order positions of one byte get shifted 
into the low-order positon of the next byte in the sequence. For 
example: 



LDY 


#3 


SHIFT 4 BITS 


LDX 


#4 


THRU 5 BYTES 


ASL 


STR,X 


RIGHT -MOST BYTE 


DEX 






ROL 


STR,X 




DEX 






BPL 


ROLIT 


ALL BYTES ? 


DEY 






BPL 


BITSH 


ALL BITS ? 



This routine would cause the string of five bytes at STR to be 
left shifted four bits. Each execution of the ROL shifts the contents 
of the Carry bit into the low order bit of the byte being shifted. 
The Carry bit will contain the bit which was shifted out of the high- 
order bit position of the previous byte. The ASL is used as the first 
shift instruction to force zero bits into the low order positions of 
the low-order bytes. 

LSR - Logical Shift Right. The contents of the A-reg or memory 
location specified is shifted one bit position to the right. The low- 
order bit gets shifted into the Carry bit. The high^order bit 
position is forced to zero. The Zero bit is set based upon the 
resulting value of the shifted byte. The Negative bit is forced to 
zero. The same addressing modes apply as for the ASL instruction. 



ROR - Rotate Right. All bits in the rotated byte are shifted one bit 



n 
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position to the right. The Carry bit is shifted into the high-order 
bit position and the low-order bit position is shifted into the Carry 
bit. The same addressing modes apply as for the ASL instruction. The 
LSR and ROR instructions are the same as the ASL and ROL instructions 
except they shift bits in the opposite directions. Note that a one- 
bit shift right results in an effective division by two. 



Boolean arithmetic instructions 



AND - Logical AND. The A-reg is logical ANDed with the specified data 
byte. The boolean AND operation is performed between corresponding 
bits of the two bytes. Each bit position of the pair of bytes is 
ooerated on individually, the result of the operation replacing the 
corresponding bit in the A-reg. The rules of the AND operation are: 
if the two bits being ANDed are value i, the result is a 1; if either 
bit is a e the result is a e. That is, CO AND 13 = e ; Ce AND = e 
; Ci AND ID = i i CI AND 93 = 0. Example: 



Only the bit positions which had aim both bytes ended up 
with a 1 in the result. The AND instruction is frequently used to 
selectively clear individual bits while maintaining the status of the 
other bits in the byte. This is done by creating a "mask-byte" which 
has a in every bit position which needs to be cleared (set to 0)» 
and a 1 in all the other bit positions. The mask byte may be in 
either the A-reg or the specified memory location but the result of 
the operation always replaces the A-reg. 

This process works because a d ANDed with either a d or a 1 
gives a result while a i ANDed with a gives a d and ANDed with a 1 
gives a i. 

ORA - Logical OR. The A-reg and the specified memory location, are 
logical ORed together, the result replacing the A-reg. The boolean OR 
ooeration, like the AND operation, is a bit by bit operation. Each bit 



11001010 

AND 10101100 



Memory 
A-reg 



10001000 



new A-reg 
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of the A-reg is ORed with the corresponding bit of the byte in memory 
by the following rules: If either bit is a if the result is a 1. If 
both bits are e, the result is e. That is» CI OR 1] = 1 ; CI OR 03 = 
1 ; Ce OR 13 1 ; e OR e = e. Example: 



11801010 Memory 
ORA 10101100 A-reg 



11101110 A-reg 

The ORA is frequently used to selectively turn bits on (set to 
i). Like with the AND> a mask must be created which indicates the 
desired bits to set and the bits to be unaffected. The OR mask must 
have a bit on in the bit positions to be set and off in the positions 
which need to be maintained. This is opposite of the AND mask. 
There* 1-bits maintained the status quo. Here* 0-bits have that 
responsibility. A 9 in the mask byte when ORed with a i gives a 1 and 
when ORed with a give a 0. And a 1 in the mask byte always results 
in a 1 result. CI OR 13 = 1; Ci or 03 = 1. Valid addressing modes are 
the same as for the AND instruction. 

BOR - Exclusive OR. The contents of the specified memory byte are 
EORed with the contents of the A-reg, replacing the A-reg with the 
result. Like the AND and OR instructions, this is a bit oriented 
instruction. The rules of Exdusive-Oring are: The result will have 
a 1 in any bit position for which only one of the two bytes being 
EORed have a one. All other bit positions of the result will have a 
0. (i.e. CI EOR 03 = 1; Cl EOR 13 = 0; C0 EOR 03 = 0; C0 EOR 13 = 1). 



Example: 



11001010 Memory 
EOR 10101100 A-reg 



01100110 New A-reg 

The EOR instruction is useful for inverting bits. A 1 in any 
mask bit position will cause the corresponding bit in the result to 
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have the opposite value as that o-f the corresponding bit in the object 
byte. A 1 be-fore EORing will result in a after and vice versa. A 
zero in the mask byte will cause the corresponding bit in the object 
byte to go unmolested. 

BIT - BIT test. The A-reg is logically ANDed with the contents oi the 
specified memory location. The Zero flag is set if the result of the 
operation gives a zero result. The Negative bit is set if the high 
order bit of the memory location is set. The Overflow bit is set if 
the second-highest-order bit ( the 6-bit ) of the memory location is 
set. The Negative and Overflow bits are cleared if the 7-bit and 6-bit 
of the memory location are clear. The A-reg is not affected by the 
execution of this instruction. 

This instruction is very useful for testing individual bits of 
bytes in memory. The A-reg is loaded with a mask which has ones in 
the bit positions to be tested and zeros in the rest. If any of the 
memory byte's bits in the tested positions are on the result of the 
ANDing operation will be non-zero. Note that the mask may be either 
in memory or in the A-reg for the test to work. The Negative and 
Overflow bits are set based only upon the bit configuration of the 
memory byte however. Example: 

mSK BYT $86 
LDA MASK 
BIT WLl 
BMI BIT? 
BVS BIT6 
BNE BIT10R2 

OK EQU 3 

The value of the byte assigned to label MASK is $06. The i- 
bit and the 2-bit are on and all others are off. The BIT instruction 
ANDs the contents of the A-reg» %Ut with the byte at VALl and the 
result will be non-zero only if either the i-bit or the 2-bit of VALl 
is a one. If VALl has its high-order bit on, the program will branch 
to BIT7. If the 6-bit is on in VALl the program will branch to BIT6. 
If either bit-2 or bit-i are on, the branch to BIT10R2 will be taken. 

The " a " is used in the last statement of the program. It 
has a special significance to The 

Assembler. Used in the operand field of an instruction it is like a 
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symbolic label except it references the current value oi the Location 
Counter. Herei it performs the function of assigning the value of the 
Location Counter to the label "OK". 



Arithmetic instructions 



ADC - ADd with Carry. Addition is performed with the A-reg, the 
specified memory location and the Carry bit. ( A-reg ) = ( A-reg ) + ( 
addr ) + ( carry ). The (...) is used here to mean "the contents 
of". The result replaces the A-reg. The mode of arithmetic is 
determined by the status of the Decimal mode bit at the time the 
instruction is executed. If set> the mode of addition is the Decimal 
mode. If clear, the mode is binary. Valid addressing modes are the 
same as for the LDA instruction. 

Binary addition is quite simple. It is Just like decimal 
addition except the highest number you have to worry about is 1. The 
rules of addition are: 

8 + 9 = 8 
8 + 1 = 1 

1 + 1 = 18 <2 in decimal) 

The third example is the only one which is different from 
decimal addition. When we add a pair of binary numbers with more than 
one bit apiece, we proceed from right to left Just like decimal 
addition. We add the two bits together and if the result is greater 
than 1 we have to carry 1. So, li + 11 = 118. Doing this addition 
one step at a time, taking the rightmost bits, i and 1, and adding 
them by the above rules, we see that the answer is 18, or 8 with a 
carry of 1. Next we add the next pair of bits plus the carry, i + 1 
+ 1 = (1 + 1) + 1 = 18 + 1 = 11. Thats a i with a carry of 1. Note 
that 1 + 1 +• 1 = 3 in decimal and 1 + 1 + 1 = 11 in binary which is 
the binary equivalent of 3 decimal. The most you have to remember in 
binary addition of two numbers is 8 + 8 = 8 ; 8 + 1 = 1; 1 + 1=18 
(8 carry 1) ; 1 + 1 + 1 = 11 (1 carry 1). The ADC instruction does 
this binary addition work for you, so you might not need to know it. 
On the other hand, you probably will when you go to debug your 
Galactic Gobbler Game. So you might Just as well learn it now. 
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When in Decimal mode> the 65i9 expects the data it is adding 
to be in "binary coded decimal" -format- This is yet another data 
•format. In BCD> the eight bits o-f a byte are interpreted to be two 
four bit decimal digits. Each four bit digit may have the hexadecimal 
values of 6-9. If there is some other bit configuration in the range 
of A-F in either half of the bytes being added* the results will be 
unmeaningful. When the ADC is executed in Decimal mode> the two low- 
order digits are added and any decimal carry is added together with 
the two high-order digits. The carry bit will be set if there is a 
decimal carry from the addition of the high-order digits. 

It is standard procedure to clear the carry bit before using 
the ADC instruction because the Carry bit is added into the result. 
This is a nice feature when you are doing multiple precision addition 
such as adding two 32 bit numbers together. The carry bit is the 
needed communication between the successive bytes of the addition. 

Example of 32 bit multiple precision addition: 

LDX #3 4 BYTE ADDITION 

CLC 

NEXT LDA K}AL\ ,X 
ADC VAL2,X 
STA VAL3,X 
DEX 

BPL NEXT 



SBC - SuBtract with Carry. The specified byte in memory and the 
inverse of the Carry bit are subtracted from the A-reg> replacing the 
A-reg with the result. That is» (A-reg) = (A-reg) - (addr) - Ci - 
(Carry) 3. The Carry bit is set if the contents of the A-reg are 
greater than or equal to the value being subtracted from it. The 
Carry bit is cleared if the value subtracted is less than the contents 
of the A-reg. In deciding whether the contents of the A-reg and the 
memory location are greater than or less than one another » the 6510 
interprets the values as unsigned integers in the range of 0-255. 

The carry bit is like an inverted borrow. If a borrow is 
requiredt the Carry bit is 0. If no borrow is required* the Carry is 
1. The Negative and Zero bits are set based on the result of the 
subtraction. The Overflow bit is set if "two's complement overflow" 
occurred. Valid addressing modes are the same as for the LDA 
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instruction. 

The normal subtraction procedure is to set the Carry bit before 
the SBC is executed. Using the SBC to compare two values requires 
testing the Minus bit after the subtraction is complete. 

H the desire is to branch to PRGA if the contents of VALl 
are less than the contents of VAL2 the following program would be 
used: 



The above routine works for unsigned numbers. If a comparison 
is being made of numbers which may have negative values* a more 
complex routine must be used. The possibility of "negative overflow" 
exists when subtracting numbers which are intended to represent values 
in the range of to 127, -1 to -128. If we try to subtract 10 from - 
124» the result would be -134. This is out of the range of negative 
numbers. The 6510 lets us know that if this was a signed operation* 
the result had "negative overflow". This is done by setting the 
Overflow bit in the Processor Status Register. The value which ends 
up in the A-reg is 122 (256-134) in the above example. The unsigned 
equivalent of the -124 is 132 (256-124). And 132 - 10 = 122. This 
positive result gives a false indication of the relative magnitude of 
the two signed numbers. When working with signed numbers the 
following technique is necessary to make accurate comparisons of 
magnitude: 



SEC 



OK 



LDA VALl 
SBC VAL2 
BMI PRGA 
EQU 3 



CHKMI 
OK 



SEC 
LDA 
SBC 
BVS 
BMI 
BPL 
BPL 
EQU 



VALl 

VAL2 

CHKMI 

PRGA 

OK 



PRGA 
3 



Positive overflow can occur the same way. Suppose VALl has 
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the value of 126 and VAL2 has the value of -4. The intention o-f the 
above program is to branch to PRGA if VALl is less than VAL2. 126 - 
(-4) = 130. 130 is out of the range of signed numbers (0-127), 
Positive overflow occured. The 6510 tells us this in the same way, by 
setting the Overflow bit. Does the program work for this case? 126 
is not less than -4. The overflow bit was set by the SBC. The branch 
is taken to CHKMI where the Negative bit is tested. It is on because 
the value in the A-reg is greater than 127. It is 130. So the branch 
is not taken to PRGA. It works! 



Compare Instructions. 



CMP - CoMPare. The magnitude of the specified memory location is 
compared with the magnitude of the A-reg. The Zero and Negative bits 
are set as though a SBC had occurred. The A-reg is not modified by 
this instruction. The carry bit need not be pre-set or cleared before 
executing the instruction. The carry bit is set if the compare finds 
that the A-reg is greater than the value of the contents of the memory 
location. The Overflow bit is not affected by this instruction. It 
is therefore not possible to use the CMP to make magnitude 
comparisons of signed numbers. The description of the SBC instruction 
illustrates the technique for accomplishing this. Valid addressing 
modes are the same as for the LDA instruction. 

CPX - ComPare the X-reg. The X-reg is compared to the contents of a 
specified memory location. This instruction functions exactly like 
the CMP instruction except the register being compared is the X-reg. 
The valid addressing modes are Absolute, Zero Page and Immediate. 

CPY - ComPare the Y-reg. The Y-reg is compared with the contents of 
the specified memory location. This instruction functions exactly 
like the CMP and CPX instructions. Addressing modes are the same as 
CPX. 
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Impotent Instructims 



NOP - NO operation. The amazing NOP instruction does absolutely 
nothing. It causes the 6510 to spin its electronic wheels for a few 
microseconds. It takes up One byte of memory. 
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Speci-Fica.±ions -for Assembly l-a.ngua.ge 
General 

This chapter gives a compact description of the capabilities 
and restrictions of the assembly language of the Develop-64. For a 
tutorial walk-through of the operational use of the tools read 
Chapters 1-4. 

The assembly language statement may be a maximum of 79 
characters in length. This is exactly two lines on the screen minus 
the prompt character ( " ). There are two kinds of statements: 
comments and regular assembly language statements. Comments must 
begin with a " ; " in the first position. There are no other 
restrictions on comments other than the disallowance of the quote ( " 
} character. This restriction applies equally well to all statements. 

Labels 

The label field» if used, is the first field of the assembly 
statement. It is not a required field. If used» it must start with a 
letter (A-Z) and may be of any length. The single character "A" 
should not be used» as it will be confused with the "A" of the 
Accumulator addressing mode when appearing in an operand field. Other 
characters which should be avoided are the seven algebraic operators 
and the quote ("). Labels of more than seven characters will cause 
the assembly listing to be somewhat less neat appearing but work ^st 
fine. 

Hnemonics 

Standard mnemonics 

The mnemonic is the English-like code which gets translated by 
Develop-64 into the machine language op-code. A discussion of the 
mnemonics is found in chapter 9. See appendix A for a complete list of 
all valid mnemonics and their legal addressing modes. 
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The BQU pseudo-op 

Develop-64 comes equipped with two special mnemonics» SQU and 
BYT. These do not generate processor-executable instructions as do 
the standard mnemonics. The BYT pseudo-op is covered in the next 
paragraph. The EQU mnemonic is an instruction to Develop-64 rather 
than an instruction to the machine. It has two -functions. The first 
is to set the location counter. This is a -function sometimes le-ft to 
a separate pseudo-op such as ORG in other assemblers. The second 
function is to equate a label with an address. The format of the EQU 
instruction is: 

LABEL EQU addr-expression 

The label field is optional. There is one exception to the 
general rules for address expressions for the EQU instruction. The 
expression may not reference labels which do not precede the EQU 
instruction in the segment. This is true only for the EQU instruction 
and is the only limitation on it. Any program references to the label 
on the EQU instruction will refer to the address expressed in the 
operand field. 

The address expression must always be present. All the rules 
and capabilities of address expression as defined below apply. 

EQUate statements are used to allow one to use meaningful 
English words instead of numeric values for addresses and other 
numbers. The EQU is set up once and all references to the assigned 
label will be interpreted by the assembler as the value associated 
with the label. The EQU may also be used to reserve a block of memory 
and assign it a symbolic label. The following two lines will assign 
the label, DATA to the 2ee-byte block of data starting at $Ceee: 

DATA EQU *C090 
EQU 3+208 

The "0" (at sign) symbolizes the location counter, explained in 
more detail later in the chapter. 
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W The BYT pseudo-c^ 

^ The BYT instruction, unlike the EQU instruction, does cause 

machine language code to be generated by Develop-64. It is not 
generally used to generate executable code like the standard 

y mnemonics. Its function is to provide a means o-f causing data to be 

stored in memory. The data generated by the BYT instruction may be 

^ specified in several ways. Depending on the first character of the 

operand field, the BYT instruction may specify hexadecimal strings or 

^ ASCII strings or address constants or single byte values of hex, 

decimal or ASCII. 

^ Hexadecimal strings 

W If the first character of the operand field is then a hex 

string will be generated. All characters following the should be 
^ hex digits, 0-9 A-F. There may be any number of such digits, up to 

^ the maximum line length constraint. Develop-64 will create one byte 

of data for each pair of digits. If there are an odd number of 
digits, Develop-64 will append a "0" on the left of the string. 

^ Literal text strifes 

^ If the first character of the operand field is a " ' all 

^ following characters will be translated to the Commodore ASCII value 

of the characters. Each text character in the operand will generate 
W one byte of data. All the characters which may be entered from the 

keyboard with the exception of the quote ( " ) are legal. The BYT 
^ literal instruction is the only instruction which cannot have a 

comment field. Comments would be interpreted as part of the literal 
^ text. The length of the literal string is limited only by the maximum 

^ line length limitation. 

^ Data constants 

^ A "<" in the first position of the operand field causes the 

expression which follows to be evaluated by the rules of address 
^ expression evaluation. The single byte which is generated is the low- 

■ j order byte of the resultant two-byte evaluation. 
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A ">" in the -first position causes the generation of a single 
byte whose value is the high-order (or page number) o-f the address 
expression which -follows. 

Address constants 

H the first character of the operand does not meet any of 
the above criteria then the operand is evaluated as an address 
expression and the two bytes of data which are generated are in the 
6510 address format » with the low-order byte preceding the high-order 
byte. It should be noted that a BYT instruction such as: 



BYT $3CC 

will not generate an address constant in the low-high format. 
It is a hexstring and will generate 03 CC. To get an address constant 
it would be required to write an instruction such as: 

BYT 0+$3CC 

which would generate CC 03, as expected. 

The following will also generate the same address expression: 

MSG EQU $3CC 
BYT MSG 



The operand field 

The operand field follows immediately after the mnemonic field 
and specifies to Develop-64 the address of the data to be accessed and 
the mode by which it will be addressed. There are actually 13 
distinct addressing modes by which the location of data is specified. 
The format of the operand field determines which mode will be used and 
therefore exactly which op-code will be generated and how many bytes 
of address data will be generated. Not all instructions may use the 
same set of addressing modes. Appendix A specifies the valid 
addressing modes for each instruction or mnemonic. 
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Address expressions 

One o-f the features oi this assembler is the ability to create 
address expressions o-f great complexity (or simplicity) with ease and 
•flexibility. The term "address expression" is meant to include the 
"immediate" character and BYT data constants as well as actual memory 
locations. Address expressions are algebraic combinations of one or 
more terms. 

Terms 

There are five different kinds of terms which may be 
algebraically combined in an address expression. Each has its own 
distinguishing format. The result of the evaluation of the expression 
must not be out of the range of -65536 to 65535 but the individual 
terms have no magnitude restrictions. Address expressions which 
exceed the magnitude restrictions will cause an ERR 6. 

Decimal format 

Any term in an address expression which begins with 0-9 or a 
"." will be interpreted as a decimal term. Decimal terms may be 
integers or may contain a decimal point and a fractional component. 
Floating point notation may also be used (e.g. 3E2 will be interpreted 
as 360). 



Hexadecimal format 

Hexadecimal terms are those which have a "$" as the first 
character. All following characters> up till the next operator or the 
end of the expression, must be 6-9, A-F. Hex terms which have 
characters other than these will cause an ERR 5 when the program is 
assembled. 

Literal format 

Any term in an address expression which begins with the 
character " ' " will be interpreted as a literal. That is, the value 
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assigned to that term will be the ASCII value of the -first character 
to the right of the " ' " . Any characters following the first 
character following the quote will be ignored. 

Symbolic label 

Any term which does not start with a "$" or a or a "9" or 
a or a number (0-9) will be interpreted as i symbolic label. 
Develop-64 will search the entire program looking for a match on the 
label field. If none is founds ERR 3 will be generated. If a match 
is found* the term will be assigned the value of the address 
associated with the label. Labels may be of any length. 

Location counter 

The location counter is Develop-64's equivalent of the program 
counter. The location counter is assigned the value of the address 
assigned to the first byte of the instruction in which it appears. It 
is the address at which the instruction will reside once The Loader 
POKES the load segment into memory. This assembler uses the "9" 
symbol to signify the location counter. Most other assemblers use 
the symbol for this function. However* the is interpreted by 
Develop-64 as a multiplication operator. The s/mbol seems a 
logical choice* being the "at" sign and signifying where we are "at" 
in memory. Any term which has "^' as its first character will have the 
value of the location counter. Any following characters within the 
term* should they exist* will be ignored. 

Algebraic operators 

The various terms of the address expression may be combined 
algebraically by the following operators; + - * / & % . As the 
evaluation proceeds from left to right* each term is added to* 
subtracted from* multiplied by* etc. the result of the evaluation of 
that portion of the expression to the left of the operator* giving a 
new current evaluation. The fractional por-t.. / e result of any 
operation will be carried into the next operation. The final 
evaluation of the expression will truncate any fractional components 
and will convert negative numbers into sixteen bit two's complement 
values. 
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Addition " + " 

The addition operator causes the term immediately -following 
the "+" to be added to the result oi the evaluation of the portion o-f 
the expression to the le-ft of the "+". 

SiAtraction " - " 

The subtraction operator causes the term to the right of the 
minus sign to be subtracted from the expression to the left of the 
minus. 

Multiplication « 

The multiplication operator causes the expression to the left 
of the " * " to be multiplied by the term to the right of the " * " . 

Division " / " 

The division operator causes the expression to the left of 
the " / " to be divided by the term to the right of the " / 

Exponentiation " " 

The exponentiation operator causes the expression to the left 
of the " " to be raised to the power of the term to the right of the 
" ^ Fractional powers may be employed with decimal terms. It is 
therefore possible to do such things as take square roots with 
expressions such as: 
X-^ .5 

Logical AND " & " 

The logical AND operator causes the result of the evaluation 
of the expression to the left of the to be logically ANDed with 
the term to the right of the . The logical AND operation compares 
the two terms of the operation bit by bitt giving a result with a bit 
set on in every bit position where both terms have a bit on. Its main 
use is to force bits off in certain desired bit positions* while 
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retaining the status quo in all other positions. 

Logical OR" %" 

The logical OR operator causes the result of the evaluation of 
the expression to the left of the to be logically OR'ed with the 
term to the right: of the . The logical OR operation compares the 
two terms of the operation bit by bit» giving a result with a bit set 
on in every bit position where either term has a bit on. Its main use 
is to force a bit on in certain desired bit positions^ while retaining 
the status quo in all other positions. 

BxpresBion evaluation 

As has been indicated in previous sections> several terms may 
be combined into an algebraic expression^ the eventual evaluation of 
which will result in the address specification. There are several 
features of the evaluation algorithm which must be understood for 
proper use of the algebraic capability. First* the order of 
evaluation is not like BASIC. Here* the expression is evaluated from 
left to rightt regardless of what operators appear in the expression. 
For example* the expression: 

LA&1+GH%$C/IJ 

would be evaluated in the following way: The address of LA would be 
AND'ed with the value i. The result would be added to the address of 
GH. That result would be OR'ed with $8C. The result of that 
(^ration would be divided by the address of IJ. The final massage of 
the expression converts negative expression values to a two's 
complement value by the addition of 65536 to the negative value. By 
way of example: 

-i = $FFFFf -2 = %F¥FE, -256 = $FF88f and -257 = $FEFF. 



">" The high-order symbol 

If the symbol is the first character of the address 
expression* the expression will be evaluated as usual but the final 
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operation will be to divide the expression's value by 256. This 
results in the high-order byte O'f a two-byte value. This is a 
convenient way of expressing the page-number of an address. Example: 

SCREEN EQU $8460 

LDA #>SCREEN 

will cause the value $04 to be loaded into the A-reg. 

The low-order symbol 

This symbol operates just like the high-order symbol except the 
final operation is to produce only the low-order byte of the address 
expression evaluation. 

Complex equations 

For those who wish to use more complex equations than can be 
handled by expressions which are evaluated strictly left to right* it 
is possible to accommodate them by a series of BQU's which themselves 
are expressions. For example* to represent an equation such as: 



(B + C- (D/E))*(F&G) 

you could write the following code: 

DE EQUD/E 
FE EQUF&G 
AB EQU B+C-DE*FE 

Much more complex expressions may be represented in a similar fashion. 
The comment field 

Comments are entered on the statement line by skipping at 
least one space after the operand field before keying the comment. 
Comments are not allowed on BYT instructions which define literal 
strings. 
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Bxplidt zero page addrtssing convention 

When zero page mode of addressing is desired it is necessary 
to explicitly indicate such desire by preceeding the address 
expression with the "left-arrow" (B), This is the only way the two- 
byte zero page addresssing mode will be selected. Omitting it will 
result in the long form of the instruction. This provides the 
capability of addressing zero page with a long instruction if desired. 
Note that this requirement is for ZP* ZPtX and ZP»Y modes only and 
not for (indir^X) and (indir)tY modes. 
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Q*ra.phics ort ±he Commodore <S4 

These next chapters will attempt to expand upon the 
information found in the Commodore 64 Programmer's Reference Guide 
(PRO). The PRG should be considered an indispensible reference tool. 
In it you will find complete descriptions of the various special 
function integrated circuits which make the 64 the powerful computer 
it is. Also included is information on the 64's memory organization 
and the "kernal" routines and how to use them. 

This chapter will provide the machine language programmer's 
perspective on graphics generation. Joy stick and paddle usage and 
sound generation will be covered in the following chapter. The last 
chapter will cover some of the internal programs contained in the 64's 
ROM and the means by which you can make use of them. 

The Video Interface Chip 

The Video Interface Chip (the VIC-II) is the electronic 
machine* the integrated circuit within the 64 whicht among other 
things* causes patterns to be displayed on your video screen. It is 
also known as the 6567. The VIC-II is connected to the 6516 and the 
RAM and ROM of the 64 via the address* data and control busses. 

The VIC-II runs continuously from the time the power is turned 
on untill it is turned off. It is under control of its own internal 
program which is built into the electronics of the chip. It has 47 8- 
bit registers which may be addressed by the 65i0 and therefore any 
program running on the 6516. The registers are the communication 
medium by which we direct the operation of the VIC-II. They are wired 
directly to the address bus in such a way that we can change their 
contents by storing data into addresses $0066 through $D62E (53248- 
53295). POKES from BASIC and STAs* STXs and STYs from machine 
language into these locations will modify the internal registers of 
the VIC-II. We will look at the specification of these registers and 
how they cause the various graphics capabilities to be activated and 
controlled. 

Bank Switching 

But first* it is necessary to understand the bank switching 
capability incorporated into another chip* the 6526 Complex interface 
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adapter chip #2 (CIA#2). Bank switching is a term which refers to the 
capability O'f disconnecting one bank o-f memory and connecting another 
bank in its place. When the VIC-II is doing its thingi it "looks at" 
a bank of memory to find the patterns to send out oi the video port 
and onto your video screen. The VIC-II is designed to "see" any one o-f 
four 16K banks of memory. Which bank it sees at any one time is 
determined by the "bank-select bits" of the CIA#2. To switch between 
.different banks the following machine language program will do the 
trick: 

B^K EQU 3 COULD BE 8,1,2 OR 3 

LDA $DD02 DATA DIR REGISTER 
ORA #3 BITS 9,1 SET TO OUTPUT 
STA $DD82 

LDA $DDe0 OUTPUT PORT A CIA«2 

nPC FORCE BITS 9,1 OFF 
ORA #BANK SELECT Br^^K 
STA $DD99 

When the 64 is powered up bank is selected automatically. 
The address range of the various banks and the corresponding value 
which must be specified in the BANK EQUate follow: 



n 
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EGU BANK NUMBER SmK ADDRESS RANGE 

3 e $eee8-$3FFF (8-1 6383) 

2 1 $40e8-$7FFF (16384-32767) 

1 2 $88e8-*BFFF < 32768-491 51 ) 

8 3 $C888-$FFFF (49152-65535) 

All data used by the VIC-II in its creation of video images 
will come from the bank of memory which is currently selected via the 
CIA#2. The map of what data will be found where in each block will 
depend on the values stored in the various VIC-II registers. 1^ 
before getting into that lets look at how the VIC-II puts characters 
on the screen. 

Multiple character sets 

You have no doubt noticed that each character which is 
displayed on your screen is a composite of up to 64 dots arranged in 
an 8 by 8 block. The information which describes the characteristic 
dot pattern of each character is stored in the 64's ROM. 

A certain section of RAM is rejserved for use by the 64 as 
"screen memory". There is one byte of screen memory reserved for every 
character position on the screen. Since there are 48 columns and 25 
rows there are 1888 bytes of screen memory. The data stcN^d in each 
position of screen memory may have the value of 8-255i the rar^e of 
values of one byte of information. This may be considered the 
character "code". Bach code stands for w\b unique pattern of dots. 
There are therefore 256 possible dot patterns which may be displayed 
at any one time. The VIC-II scans continuously through screen memory 
and translates each code for all 1888 screen positions. The 
translation process consists of using the value of the ccKJe (8-255) to 
compute the displacement (or number of bytes) into a character pattern 
table. Each character pattern has 64 bits (8 bytes) of "dot" 
information. So to find the right pattern* the VIC-II multiplies the 
value of the code by 8 and adds the result to the starting address of 
the character pattern table. There, the VIC-II finds the 8-byte 
pattern of dots to send to the video screen. The first eight bits of 
a character's pattern are the top row of dots which appear on the 
screen. The second eight bits are the second row and so m until! the 



n 



Iniidt Thff Commodore 64 Page il-4 



eighth eight bits for the bottom row. The VIC-II does this scanning 
oi screen memory and translating the codes found there using the 
pattern table and sending the dot information out to the video port 
all automatically and continuously. 

The BASIC "PRINT" statement causes "screen codes" to be stored 
in screen memory. It is possible also to POKE screen codes into 
screen memory. Machine language programs may store screen codes into 
screen memory. The VIC-II automatically and continuously scans the 
screen memory> getting one screen code per screen location and* 
translates the screen code into an eight by eight dot pattern which it 
then sends to the video output port to be displayed. In appendix B of 
the PRG there is a table of screen codes and the corresponding 
characters which get displayed. These are the standard characters 
which are burned into the 64's character-table ROM at $D0e0-$DiFF 
(53248-55295). 

You are probably aware that when you hold the Commodore and 
the Shift Keys down simultaneously* the characters which appear on the 
screen are from a second character set. One character set contains 
upper and lower case characters and the other contains upper case and 
the graphics characters. There are two sets of 8 x 8 patterns stored 
in ROM and the VIC-II can be "switched" between the sets. In fact* 
the VIC-II can be switched between several different tables of 8 X 8 
patterns. One of the VIC-II's registers determines where in the bank 
the character table is to be found. Since each bank which the VIC-II 
can see is 16K bytes long and since 256 characters take 8 * 256 or 
2948 (2K) bytesf there can be eight different character tables 
accessible to the VIC-II in any given bank. Since there are 4 banks 
available* there may be up to 32 separate character sets accessible to 
the VIC-II. 

The register which controls which of the eight blocks within 
the current bank to use for the character pattern table is found at 
53272 ($0618). It takes three bits to specify the pattern location. 
These three bits are bits 3* 2 and i of the register. The four high- 
order bits of this same register are used for another purpose and must 
not be modified when switching between character sets. Bit-6 is not 
significant. The following routine illustrates the selecting of the 
desired character-pattern table. 
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TABLE EQU 6 OR 2 OR 4, 6, 8, 10, 12 OR 14 

LDA 53272 GET THE REGISTER 

AND «*F0 TURN BITS 3-8 OFF 

ORA #TABLE SET THE TABLE-SELECT BITS 

STA 53272 RESET THE REGISTER 

The value the TABLE EQU selects the location o^ the 
character pattern table within the selected banK. The following 
table gives the position within the bank for the various possible 
values of TABLE: 



TABLE 


LOCATION WITHIN BANK 





^0008 


-$07FF 


<0-2047) 


2 


$0800 


-$0FFF 


< 2048-4095) 


4 


$1000 


-$17FF 


<4096-6143) 


6 


$1800 


-$1FFF 


<6144-8191) 


8 


$2000 


-$27FF 


<8192-10239) 


10 


$2800 


-$2FFF 


(10240-12287) 


12 


$3000 


-$37FF 


(12288-14335) 


14 


$3800 


-$3FFF 


(14336-16385) 



Since the location specified above is the relative address 
within the currently selected bank, to arrive at the actual address of 
the character pattern table it is necessary to add the starting 
address of the selected bank to the addresses above. Selecting an 
alternate table address and creating your own pattern table is the 
technique which you must use to create your own custom characters and 
to do high-resolution bit-image graphics. We'll discuss those 
capabilities more later. 

The Commodore 64 comes pre-programmed with only two character 
pattern tables* the uppe^-case/graphics set and the upper/lower case 
set. These are in ROM at SDOOe-DlFF and $D8ee-$DFFF. This also 
happens to be where the VIC-II's registers reside, which seems mighty 
confusing at first. There is an explanation. The 6510 has a very 
interesting feature which allows both RAM, ROM and I/O to all occupy 
the same address space. Not at the same time of course. The bank 
switching concept is used here. We discussed at the end of Chapter 7 
the special characteristics relating to location and 1 m the 6510's 
memory space. We mentioned at that time that the 64 uses the I/O port 
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at 0»1 for its own special purposes. This port controls a banK- 
switching device which switches RAM> ROM and I/O in and out of the 
memory space. This is the way the 64 can have a full 64K of RAM» 20K 
of ROM and 4K of I/O all addressable on a i6-*bit address bus which can 
only have 64K possible unique addi^esses. 

If the programmer wishes to copy a part or all of the. character 
ROM into some part of RAM# it will be necessary to switch the I/O at 
$D9ee out and switch the ROM in. Because interrupt processing on the 
64 utilizes the I/O which you want to switch out» it is necessary to 
disable interrupts before switching in the ROM. The following routine 
will turn off interrupts! switch in the ROM» move the character tablet 
switch the I/O back in and turn interrupts back on. 



LDA 


56334 




AND 


#*FE 


SET BIT 8 OFF 


STA 


56334 


TURNS INTERRUPTS OFF 


LDA 


Bl 




AND 


nFB 


BIT 2 OFF 


STA 


Bl 


SWITCHES ROM IN 


LDX 


#8 


COUNT OF PAGES TO MOVE 


LDY 


#8 


BYTE COLHMTER 


LDA 


<SRCE) 


,Y 


STA 


<DEST) 


rY 


INY 








LOOP 




DEX 




DECR PAGES BY 1 


BEQ 


DONE 




INC 


BSRCE+1 NEXT PAGE OF DATA ' 


INC 


BDEST+1 NEXT PAGE OF WHERE 


JMP 


LOOP 


DO NOTHER PAGE 


LDA 


Bl 




ORA 


#4 




STA 


Bl 


SWITCH I/O BACK IN 


LDA 


56334 




ORA 


#1 


TURN INTERRUPTS ^CK 


STA 


56334 





ROM OUT 



This routine assumes SRCE and DEST are labels de-fined elsewhere 
in the program which address two-byte zero-page vectors which have 
been pre-set to address the character pattern ROM and the place you 
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wish to move the character table to. 

When the system is powered up bank « and TABLE 4 are 
automatically selected by the power-up program. The 64 has another 
feature which can be either convenient or a bother depending on your 
needs. When bank or bank 2 is selected and the TABLE value is 4 or 
6 the VIC-II will get the character patterns from the standard ROM 
pattern table rather than from RAM as you might expect. Thus» the 
VIC-II sees the ROM character patterns at $ieee-$lFFF and at $9eee- 
$9FFF even though there is really RAM there. It's a very tricky chipt 
that VIC-II. Note that this is a VIC-II related phenomenon only. The 
memory at these addresses is really RAM and you may treat it as such 
for all purposes. Programs and data stored there will not be in any 
way molested. 

Now> to create your own custom characters you must build a 
pattern table which describes the dot patterns of the characters you 
wish to build. The pattern tables consist of up to 256 patterns. Each 
pattern has eight bytes. A bit turned on in any of the bytes will 
cause the corresponding dot on the screen to be illuminated. (The 
screen dots are also called pixels which comes from "picture 
elements".) 

In the standard pattern table the screen code "d" refers to the 
first 8-byte pattern^ that of the character "9". This pattern may be 
found beginning at 53248 ($Ddd0) when the ROM has been switched in. 
ree the above routine for switching the ROM in machine language. To 
do it in BASIC the following routine could be used. 

POKE 56334,PEEK(56334)AND254: POKE irPEEK(i)AND251 

The second character in the standard character ROM starts at 53256 and 
is the pattern for the letter "A" (screen code 1). Every eight bytes, 
another pattern is stored. This goes on for 256 8-byte patterns. The 
screen codes 128-255 are the "reverse" of the first 128 patterns. 
That is» where a bit is on in one, it is off in the other. 

The first byte of screen memory holds the character code which 
corresponds to a 8 by 8 pattern in the table to be displayed in the 
first column of the first row of the screen. The first 40 positions 
of screen memory correspond to the first row of the screen. The 
second 40 characters correspond to the second row and so forth. 

At power-on time the 64's bank address is initialized to $0000 
and the screen memory location is set to $0400 (1024). You may create 



Infidt Tht CommtNlort 64 



Ptgt ii-8 



and switch beiween several screens very rapidly to create the e-ffect 
o-f a foreground /background or for other interesting effects. 

If you POKE 1024,1 the screen code "1" will be placed in the 
screen memory position corresponding to the upper left character ^ 
position of the screen. Do it and you should see the letter "A" 
appear there. The VIC-II has translated the value 1 into the 
character pattern for the letter "A" by computing Kthe character 
code) * 8 (the number of bytes per pattern) and adding that to the 
start of the character pattern table which starts at 53248 (ROM 
location which can only be PEEKed by switching the I/O out and the ROM 
in as explained above). It starts at that address (53256) building 
the dot pattern to send to the video screen. It finds the following 
eight bytes of data starting at 53256: 



addr 


dec 


hex 


bi nary 


53256 


24 


$18 


00011000 


53257 


60 


$3C 


00111100 


53258 


182 


$66 


01100110 


53259 


126 


$7E 


01111110 


53268 


102 


$66 


01100110 


53261 


102 


$66 


01100110 


53262 


102 


$66 


01100110 


53263 





$00 


00000000 



If you look at the above pattern of ones and zeros* you will 
be able to see the shape of the character "A" formed by the ones on 
the backgraound of zeros. All of the characters' shapes are formed in 
the same fashion. The characters you form in your program must follow 
the same rules. 

To create the new characters it is necessary to build a set of 
8-byte patterns in the same way the original set is constructed. It 
is not necessary to reserve a complete 2048 byte block of memory for a 
complete 256 characters if you only have a few characters you wish to 
ever see on the screen. However, you may not use both the standard 
sets and any special programmed sets simultaneously. Once the bank 
address and the VIC-II's register at 53272 ($D0i8) has been set, the 
entire screen will be generated using the character patterns found at 
the specified pattern table area. 
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Multiple Screens 

The location of screen memory is determined by both the i6K 
bank selected as described above and the high-order 4 bits of the 
register found at 53272 ($D018). The location of screen memory within 
the bank may be selected with the following simple routine: 



SCRN EQU ^ee (OR $18,28,38,48,50, .. .E0,F9) 
LDA *D018 GET REGISTER 

AND mF TURN OFF HIGH 4 BITS, SAVE LOW 4 
ORA #SCRN TURN ON THE SCREEN SELECT 
STA *D818 SAVE NEW REGISTER 



There are 16 possible locations within the current bank at 
which screen memory can begin. Screen memory is 1888 bytes long (25 x 
48). The following table defines the displacement within the bank for 
the beginning of each of the possible screen locations and the value 
of SCRN which will select each. 



SCRN SCREEN MEMORY STARTING ADDRESS WITHIN BANK 



$80 


$8888 


<0) 


$18 


$8408 


(1024) 


$28 


$8880 


(2048) 


$38 


$0C00 


(3072) 


$48 


$1000 


(4096) 


$58 


$1400 


(5120) 


$68 


$1800 


(6144) 


$78 


$1C00 


(7168) 


$88 


$2008 


(8192) 


$98 


$2400 


(9216) 


$A8 


$2800 


(10240) 


$B8 


$2C00 


(11264) 


$C8 


$3000 


(12288) 


$08 


$3400 


(13312) 


$E8 


$3800 


(14336) 


$F8 


$3C00 


(15360) 
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Color controls 

The border around the area where characters are displa/ed is 
called the border or exterior area. The color of that area may be 
set independently o-f all other colors. The register at 53280 controls 
the border color. To set it the "following program sequence may be 
used: 

BORDER EQU 53288 

LDA ttCOLOR <MAY BE IN RANGE OF 9-15) 
STA BORDER 

COLOR must have been de-fined in the label file of some EQU 
with the operand being a number having the value of 0-15. The value 
chosen will determine the actual color of the border area: 






- Black 


8 


- Orange 


1 


- Whi te 


9 


- Brown 


2 


- Red 


10 


- Light Red 


3 


- C/an 


11 


- Gray 1 


4 


- Purple 


12 


- Gray 2 


5 


- Green 


13 


- Light Green 


6 


- Blue 


14 


- Light Blue 


7 


- Yell ow 


15 


- Gra/ 3 



The color of the background of the screen ma/ be selected with 
the same variety of choices. The register which controls background 
color is at $D02i (53281). A similar few statements may be used to 
modify the screen color. 

SCRNCLR EQU 53281 
LDA ttCOLOR 
STA SCRNCLR 

Character colors 

The individual characters displayed on the screen may have their 
colors set independent of any other character. There is a block of 
RAM reserved for just this purpose. Unfortunately, it is one area of 
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control information which is not selectable like the screen or 
character pattern table. That is» there is only one color memory area 
and it defines the color of each of the 1000 character positions c»> 
the screen regardless of which screen memory or character set you are 
usir^. The 1000 bytes of color memory starts at 55296 ($D800) and 
runs through 56295 ($DBB7). The first 40 bytes define the color of 
the top row of characters and so on. The 16 possible colors and the 
vlaues which correspond to them are those listed above for the 
background mi border. 

Altimati display modts 

There are two control bits which fiA'ther determine the way the 
VIC-II interprets character shape data from the character memory. The 
4-bit in the register at 53270 sets the multi-color mode. The 5-bit 
of the register at 53265 sets the high-res bit map mode. Either or 
both of these bits may be set and reset by the programmer by typical 
bit-manipulation code: 



HIRES 


EQU 


53265 






MULT I 


EQU 


53278 






SETHI 


LDA 


HIRES 


GET THE HIRES REGISTER 




ORA 


#32 


OR m THE 5-BIT 






STA 


HIRES 


STORE THE NEW HIRES 


REGISTER 


SETMC LDA 


MULT I 


GET THE MULTI-COLOR 


REGISTER 




ORA 


#16 


OR ON THE 4-BIT 






STA 


MULTI 


STORE THE NEW MULTI - 


-COLOR REG 


CLRHI 


LDA 


HIRES 








^D 


#*DF 


AND OFF THE 5-BIT 






STA 


HIRES 






CLRMC 


LDA 


MULTI 








AND 


#^EF 


AND OFF THE 4-BIT 






STA 


MULTI 







The way in which the video display is created depends upon the 
value of these two bits and sometimes on the value of the individual 
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screen color memory bytes. The -following table summarizes the 
possibilities: 

Multi- Hi -res Bit-3 o-f Mode 
color color mem 



8 any Std Char ''en lire screen) 

1 Std Char < this character) 
1 1 Multi-color (this char) 

1 1 any Multi-color bit map (screen) 

1 any Bi I mapped hi-res (screen) 

Multi-color Characters 

If multi-color is selected and hi-res is not» the characters in 
the character pattern table will all be displayed in what is called 
multi-color mode. In multi-color mode of display* the character 
table which describes the shape of the patterns of each of the 
characters will be interpreted in a different fashion by the VIC-II. 
In the standard character display mode each of the 64 bits of the 
character pattern represents a background /foreground choice (bit on = 
display the pixel in the color set in color memory for the character 
in question i bit off = pixel is set to background color i.e. 
invisible). Here* in multi-color mode, the characters are of lower 
resolution. Each byte of the character pattern describes only four 
pieces of display information instead of eight. The bits of the 
pattern information are grouped in twos and the characters displayed 
will have four double-wide dots in eight vertical rows. The pairs of 
bits in each byte will determine the color of the double-wide dots in 
the following way: If the pair is a 00 the color of that dot will be 
the same as the background* or a non-display dot. If the value is a 
01 the color of the double-wide dot will be that of the "background 
color #1" which is set in the register at 53282 ($D022). If 'the 
value of the bit pair is a 10* the color will be that set in the 
register at 53283 ($D023) (the background color #2). If the bit-pair 
has the value of 1 1 the color of the displayed fat dot will be the 
color which is found m the color memory associated with the character 
position on the screen. Since the 3-bit of the color memory byte must 
be on to activate multi-color character mode* only the second eight 
colors (colors 8-15). may be used for the "character color" in multi- 
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color mode. 

H bit-3 o-f the character color byte for any given screen 
position is not on^ the usual standard resolution character is 
generated. Here» the only colors which may be used are 0-7. 

Bit mapped Graphics 

In this mode each pixel on the screen may be individually 
turned on and off. It is useful for plotting geometric shapes and for 
graphing functions and creating complex graphics. 

Since there are 1000 screen positions and each position has 64 
pixels, it must take 64,000 bits or 8000 bytes to store all the screen 
information in bit-mapped mode. Bit-mapped mode is activated by 
setting bit-5 of the register at 53265 ($D0 11) as indicated above. 
Once the mode has been selected, • the VIC-II now uses screen memory to 
indicate the color combination of the bits which are turned on and off 
in the eight by eight square of the screen. The high-order four bits 
tell it the color of the bits which are set to 1. The low-order four 
bits tell it the color of the bits which are set to 0. 

But where are the bits stored which indicate pixels to 
illuminated in the two possible colors? In standard character mode 
recall that the screen memory bytes told the VIC-II where to go to 
find the character bit pattern to display on the screen. In bit- 
mapped mode the character memory is still where the information is 
stored. But now the first eight bytes of character memory always 
corresponds to the 64 pixels in the upper left corner of the screen. 
The first byte contains the pixel information for the top row of eight 
dots. The second byte contains the information for the row of eight 
dots immediately below the first row and so forth untill the eigth row 
eight dots in the upper left corner of the screen. The second eight 
bytes contains the dot information of the second 8 by 8 square on the 
first row of the screen. The 40th group of eight b/tes corresponds to 
the upper right corner and the 1000th eight bytes contains the 
information for the lower right 64-bit square. The program in 
the appendix illustrates in detail how the machine language programmer 
can plot points on the screen by computing the proper byte and bit to 
turn on or off given a pair of numbers which can vary from 0-319 and 
0-199 (the X and y axis of the plot). 
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Multi-color bit-mapped mode 

By setting both the hi-res and the multi-color bits you can bit 
map using three colors in addition to the background screen color. 
This is similar to multi-color mode in that the dots are -fat in the 
horizontal direction and the bits which indicate what is on and off on 
the screen are grouped in pairs. The same amount of memory is 
required to multi-color bit map the screen> 8066 bytes. It is» like 
in standard bit-map mode» found where the character pattern table is 
set to be. The four two-bit combinations in each byte tell the VIC-II 
which colors to make the fat dots on the screen. A "86" combination 
says make it the background color. A "61" says make it the color 
indicated by the high-order four bits of the associated screen memory 
byte. A "16" combination says make it the color indicated by the low- 
order four bits of the screen memory byte. Finally* the "11" 
combination says make it the color set in the color memory byte 
associated with the screen location in question. 

Extended bacKgrc^md color mode 

Unbelievably* there are still more modes of display available 
through the combined electronic intelligence of the 6516 and the VIC- 
II chip. If you have somehow made it this far, you might as well wade 
through this one too because sprites are still to come. 

This mode is selected by turning on the 6-bit of the register 
at 53265 ($D6il). What it does is to let you vary the background 
color from character to character if you are not satisfied with having 
the same background on the entire screen. The way it's done is: The 
two high-order bits of the screen memory bytes are interpreted as a 
background color selector. The first thing this means is that in this 
mode the character set is limited to 64 characters (the remaining 6 
bits can only have 64 possible unique values). The two selector bits 
indicate the register for the VIC-II to use to make the background 
color. The following table gives the possibilities: 
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Bit-7 Blt-6 Background color register 





e 





1 



1 



53281 
53282 
53283 
53284 



(*D021) 
<*D022) 
<$D023) 
<*D024> 



You may set the registers with the usual 16 possible color 
codes as identified above. 

Sprite Graphics 

The subject we've all been waiting for. As you probably knowf 
sprites are special movable -figures which may be designed to have any 
shape and color combination and will coexist with all other modes of 
display simultaneously. They are nice game programmers' tools. It is 
recommended you read the description of sprites and their capabilities 
in the PRG> as it is quite good. Once you have a comfortable feeling 
about machine language you will be able to translate the BASIC 
statements given in the PRG easily to assembler. 

Eight sprites may be defined at one time. The method of sprite 
definition is identical to that of custom character definition. In 
fact* there are two modes of sprite definition* standard and 
multicolor* just liKe characters. The multi-color mode mimics the 
other multi-color standards. 

The standard sprite is 24 dots wide by 21 high. The multi- 
color sprite takes just as much space on the screen but each 
definable dot in the horizontal direction is twice as fat a 
standard dot. Therefore* there are only 12 definable horizontal 
positions in the multi-color sprite. Also* the bits which define the 
shape of the sprite are grouped in pairs for multi-color* again ^st 
like multi-color characters. The standard sprite has higher 
resolution but may be of only one color. 

The memory location where sprites are "drawn" must be in the 
same 16 K block as the screen memory and character memory as explained 
at the beginning of this chapter. At the end of the 1 K block of 
memory which holds the screen memory the VIC-II expects to find the 
pointers to the sprite definitions. Each pointer is a single byte and 
may have a value in the range of 0-255. The pointer value* when 



Inside The Commodore 64 



Ptge 11 



multiplied by 64 and added to the base address the bank, will point 
the VIC-II to the sprite definition block. The VIC-II does all that 
arithmetic itseH. You needn't worry about it any more than to set it" 
up once correctly. That is, you must pick the place in memory where 
you would like to build a sprite (it must be on an even 64-byte 
boundary)* compute how far that is from the beginning of the block* 
divide by 64 and store that value in the sprite pointer location at 
the end of the screen memory Ik block. Got that? 

The sprites are numbered 0-7 and the corresponding sprite 
pointers are in locations 1016-1023 of the screen memory block. The 
sprite number also specifies the sprite intersection priority. The 
lower the sprite number, the higher the priority. This means that 
when two moving sprites pass each other on the screen, the one with 
the lower sprite number will pass in front of the higher numbered 
sprite. Transparent areas in the front-passing sprite will enable the 
lower-priority sprite to be seen through the "window". 

There is a "sprite-enable" register at $D015 (53269) which is 
the way sprites are triggered once they have been built and pointed- 
to. The VIC-II, when it detects a sprite has been enabled, will find 
its shape definition via the pointer, its desired location on the 
screen via another set of registers. It will proceed to then build 
the video signal to reflect the description you have provided it. The 
sprite-enable register has an enable bit for each sprite. Logically 
enough, bit-0 enables sprite-0 and bit-1 enables sprite-1, etc. 

Each standard sprite may have any of the 16 possible colors. 
The registers which determine sprite color are at 53287-53294 ($D027- 
$D02E) for sprites 0-7 respectively. All dots which are "on" as 
flagged by a bit on in the 63 byte sprite descriptor area will have 
the color indicated in the appropriate register. The other space as 
defined by bits turned off (set to 0) will take the color of whatever 
background is behind the sprite at any given time. As mentioned 
before, the sprites may have more than one color if defined as a 
multi-color sprite. This is accomplished by setting the corresponding 
bit (0-7) in the sprite multi-color register at 53276 ($D01C). When a 
sprite is so selected, the VIC-II will interpret the bit pairs of the 
sprite shape description in the following way: A "00" bit pair will 
cause transparency. That is, the background will shine through. A 
bit pair of "01" will cause the double-wide dots having that 
definition to be displayed in the color set in the sprite multi-color 
register #0 at 53285 ($D025). The bit pair "10" will cause the 
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a-f ore mentioned sprite color register appropriate for the sprite in 
question (at 53287-53294) to appear. Finally, a bit pair o-f "11" will 
cause the color set in sprite multi-color register #1 at 53286 ($D026) 
to shade all parts of the sprite which are set up with the "11" 
definition. 

Sprites may be expanded in both the horizontal and the vertical 
directions. Registers at 53277 ($D01D) and 53271 ($D017) are the 
sprite-expand registers for the horizontal and the vertical directions 
respectively. The bit-positions in each register correspond to the 
sprite to expand. When the bit is on the sprite will be automatically 
expanded to twice its size in the axis selected. The direction of 
expansion is to the left and toward the bottom of the screen. 

To position a sprite on the screen, it is necessary to tell the 
VIC-II where you want it to go. As you might have guessed, there are 
some registers which do ^st that. The sprites may be positioned on 
or off the screen. There is a sort-of sprite overflow area on all 
borders of the screen. Sprites may be made to drift smoothly off the 
screen by properly defining the position of the sprite. 

The position which you must give to the VIC-II is that of the 
upper left-most dot of the sprite, even if that dot is defined as an 
invisible dot. The position you define is a horizontal pixel 
position and a vertical pixel position of that upper-left corner of 
the sprite. Horizontal positions may vary from to 511 and vertical 
from .0 to 255. Since there are only 320 pixels by 200 in the actual 
viewing area this leaves the necessary space above, below and to the 
right and left of the screen for off-screen sprite movement. The left 
of the screen is horizontal pixel position 24 and the right side of 
the viewable screen is pixel position 343. So, a sprite would be 
visible at least partially if the specified horizontal position were 
between 1 and 343 (assuming that there are non-transparent dots in the 
rightmost and leftmost columns of dot positions in the sprite 
definition). Sprites expanded in the horizontal direction will be at 
least partially visible if the specified horizontal position is less 
than 343 or greater than 488. The second condition is due to the 
wrap-around nature of the pixel addressing scheme used by the VIC-II. 
Position 511 is equivalent to -1 on the left side of the screen. 

The top of the screen may be considered to be vertical pixel 
position 50 (from the top of the off-screen area which starts at 0). 
The bottom of the screen is pixel position is 249. Normal sprites 
will be completely off the top of the viewing screen if the vertical 
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sprite position is set at 29 or less. It will be off the bottom if 
the vertical position is 250 or greater. Expanded sprites will be off 
screen if less than 9 and if greater than 249. 

The registers to set position information are at 53248 through 
532634. The first 16 registers are the horizontal and vertical 
position registers for sprites 0-7 respectively. The horizontal 
position needs more information than can be contained in a single 
byte» however. Up to 512 unique pixel positions may be specified for 
the horizontal direction. Therefore another bit is required to 
completely define the position. That bit is found in the Most- 
significant-bit register at 53248. Each sprite, 0-7 has its 
horizontal most-significant-bit of position information stored in the 
corresponding (0-7) bit positions of the MSB register. Smooth 
horizontal sprite movements will take some extra care from the 
programmer to Keep track of the position and set that extra bit 
correctly. 

Finally, collision detection must be covered. Sprites may 
collide with other sprites and with the background. It can be nice to 
know when a collision has occurred. The versatile little VIC-II 
watches over its video domain and reports all such happenings to you. 
All you have to do is read the register which the VIC-II maintains for 
that purpose. 

Collisions are defined as a non-transparent portion of a sprite 
overlaps a non-transparent portion of another sprite or background 
characters. For the purpose of collision detection, multi-color 
sprite dots defined with the "01" bit pair are considered transparent. 
A little quirk there. 

The sprite-sprite collision register is at 53278 ($D0iE) and each 
bit in the register stands for a sprite. Any time a sprite is 
involved in a collision with another sprite both sprite bits are 
turned on in the collision register. So, if you care if collisions 
occur, it will be necessary to check the register after every movement 
of the sprites you are concerned about. Reading the register will 
cause it to be cleared automatically. You can not prevent that from 
happening, so if you want the information for future reference you 
must store it someplace where you can get at it. 

Sprites can also collide with the background (text, etc). Like 
sprite-sprite collision, sprite-data collisions are kept in a register 
(53279 $D01F). Each sprite has its own bit (0-7) and indicates that 
that sprite has been involved in a collision. This register is also 
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cleared by a read oi the register (LDA> LDXt LDY instruction)) so save 
it if you don't want to lose it. 

Once again» its very strongly recommended you study the PRG for 
all areas of graphic programming. The insights which may be gained 
from reading and understanding the BASIC programmer's perspective on 
these subjects will greatly increase your understanding and ability to 
move into assembly language. 
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The cS581 — A Sound syn-thesiser 

The Commodore 64 comes equipped with a very respectable single- 
chip sound synthesizer. It has three voices* each with independent 
attack-decay-sustain-release (ASDR) envelopes* -four Kinds o-f filters* 
a resonance control and a master volume control. The programmer can 
make the computer generate a wide variety o-f musical and other sounds* 
simulating various instruments solo and in concert. The sound output 
may be played through the speaker on your TV or directed to your 
stereo for high-fidelity output. 

The music and associated wave shape theory which is required to 
accomplish these ends is considerable. This chapter will present you 
with the necessary technical information on the requirements for 
programming the synthesizer. It will not go deeply into the theory 
of synthesized sound. The PRG is a source of more detailed 
information on the subject. 

Register Assignment 

The synthesizer chip is called the 6581 or "SID" (sound 
interface device) chip. The chip should be initialized before 
attempting any sound generation. It has a set of 29 registers which 
are directly addressable by the 6510 and therefore any program running 
on it. Initializing may be accomplished by setting the registers to 
zero: 



SID 


EOU 


$0408 






LDX 


#$18 




LDA 


#8 


r\ 


LOOP 


STA 


SID,X 






DEX 








BPL 


LOOP 





The register set is a contiguous string of bytes starting at 
$D4ee (54272) and running through $D41C (54230). This block of 
registers is in the I/O block at $Deee-$DFFF which also contains the 
VIC-II chip and which may be switched with the character ROM as 
explained in the previous chapter. 



n 
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Tone Generation 

The SID chip contains three tone generators, their associated 
envelope generators and the filtering and volume controls. There are 
seven registers -for each oi the three voices. The first voice's 
registers are at $0408-0406 (54272-54278). The second voice is at 
$D407-$D40D (54279-54285) and the third voice is at $D40E-D414 (54286- 
54292). 

The individual voices may have frequencies ranging from 0- 
3894 hz. To cause any given frequency to be generated, it is 
necessary to store a 1 6-bit number in the first two registers for the 
voice desired. The value of the number to store is 16.777 times the 
frequency desired. In Appendix of the PRO there is a description of 
the design criteria for a routine to select any of the 12 semi-tones 
of any of eight octaves. The following program segment will 
accomplish those ends: 

UOICE 1 FREQ LOW 
FREQ HI 



LOW 


EQU 


*D4ee 


HI 


EQU 


$0461 


NOTES 


EQU 


$C080 


C7 


BYT 


34334 


C#7 


BYT 


36376 


D7 


BYT 


38539 


D#7 


BYT 


40838 


E7 


BYT 


43258 


F7 


BYT 


45830 


F#7 


BYT 


48556 


67 


BYT 


51443 


G#7 


BYT 


54502 


A7 


BYT 


57743 


A#7 


BYT 


61176 


B7 


BYT 


64814 


SELCT 


EQU 


9 



REG A MUST HME NOTE IN LOW 4 BITS (0-11) 
OCTAVE IN HIGH 4 BITS <0-7;) 

TAX SA'v'E FOR OCTA'JE 

AND #*0F JUST THE NOTE 
ASL A NOTE * 2 
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BLWP 



OUT 



1 HI 




INDEX INTO NOTE TABLE 


n 


LUH 


NOTE+1 






CTA 


HI 






rs 


1 HA 
LUH 


NOTE 








STA 


LO 








TXA 




RETRIEVE NOTE/OCT 




AND 




JUST THE OCTAVE 




TAX 








r) 


ADC 


#$ie 








BMI 


OUT 






ns 


ROR 


HI 




DIVIDE FREQ BY TWO 




ROR 


im 




FOR EACH OCTAVE 


r\ 


CLC 










BCC 


BUMP 








RTS 






ALL DONE 





Wave ^ape regulation 

Each voice may have its wave shape independently set. The 
wave shape affects the timbre of the generated tone. The four 
possible waveforms are triangle <flute type sound)# sawtooth (brass 
type sound) f variable pulse (wide variety of possibilities) » and white 
noise. The shape information is set in bits 7-4 of the fourth byte of 
each voice's register set. More than one wave shape may be selected 
per voice but the resulting waveform will not be generally useful. 
The following routine will set the wave shape. 



SID EQU $0488 
VOICE EQU 8 
SEC 

LDA #8 
ROR A 
ROR A 
ROR A 
ROR A 



<0R 1 OR 2) 



ONCE FOR NOISE 
TWICE FOR PULSE 
THRICE FOR SAWTOOTH 
FOUR TIMES FOR TRIANGLE 



STA V0ICE*7+4+SID 
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Pulse width must be specified if pulse waveform is selected. 
The pulse width is set by specifying the percentage of time the pulse 
is on versus the time it is off. Fifty percent creates a square wave. 
0% and 100% cause a constant signal output which is therefore not an 
audio tone. The width is set as a 12-bit value which is related to 
percent on-time by the following formula: WIDTH = TIME% * 40.95 The 
low-order eight bits are set in the third register of the voice's set. 
The high-order 4 bits of WIDTH are set in the low four bits of the 
fourth register. 

WIDTH EQU PCTON*40.95 
LDA #WIDTH/256 
STA M0ICE*7+SID+3 
LDA #WIDTH&255 
STA V^0ICE+7+SID+2 

Each voice has a programmable envelope generator which allows 
you to program the volume of the output signal in several phases. The 
attack phase is when the note begins and increases in volume to its 
maximum. The decay phase follows the reaching of maximum volume and 
continues as the volume decreases till it reaches the sustain phase. 
Here the note maintains a constant volume until the release phase* 
when the volume decreases back to zero. The envelope generator allows 
you to program the rate of volume increase in the attack phase t the 
rate of decrease in the decay phase* the level at which it sustains 
and the rate of final decrease during the release phase. 

The note is started by turning on the start bit (called the 
gate signal) in bit-0 of the fifth register of the voice: 

LDA #1 

ORA M0ICE*7+SID+4 
STA U0ICE*7+SI0+4 

The attack rate is set in the sixth register* the high-order 
four bits (7-3). The value of the four-bit field corresponds to the 
time it takes for the tone to reach maximum volume as indicated in the 
following table. 

The decay rate is set in the low-order four bits of the same 
register as the attack. The corresponding table values (in seconds) 
are the times for the volume to decrease to the sustain level. 
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The sustain level is a four-bit value in the high-order nybble 
o-f the seventh register of each voice. The sustain value (0-15) 
controls the relative volume of the generated tone at which decay 
stops and the note is held until released. The volume at which 
sustain occurs is in ratio to the peak volume as the sustain register 
is to 15. Note that the peak volume is the same for all voices and 
is under control of the master volume control. The release 
rate is set in the low-order nybble of the seventh register. It 
specifies the time it will take the note to complete its decay once 
sustain has been terminated. 

The note is turned on (gated) by the gate bit which is bit-6> 
the low-order bit of the sixth register. When this bit is i the note 
will commence. It will go through the attack* decay and sustain phase 
and hold there until the bit is set to 0. 

The following table gives the value of the various four-bit 
registers which control the envelope generators and the time in 
seconds between commencement and cessation of each phase. 

'v'ALUE ATTACK DECAY/REL WLUE ATTACK DECAY/REL 






.802 


.006 


8 


.1 


.3 


4 

X 


.008 


.024 


9 


.25 


.75 


2 


.016 


.048 


10 


.5 


1.5 


3 


.024 


.072 


11 


.8 


2.4 


4 


.038 


.114 


12 


1 .0 


3.0 


5 


.056 


.168 


13 


3.0 


9.0 


6 


.068 


.204 


14 


5.0 


15.0 


7 


.08 


.24 


15 


8.0 


24.0 



Filtering 

There are four kinds of signal filtering plus resonance 
control which may be employed. Individual voices may be independently 
connected and disconnected to the filter. The filter has an 11 -bit 
register which is the frequency cut-off point and ranges from 30 to 
12khz. The low-pass filter will reject all frequencies above the cut- 
off frequency. The high-pass will reject all frequencies below the 
cut-off. The band pass filter will allow only the selected frequency 
and the notch-reject will pass all frequencies except the specified 
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•frequency. Finally^ the resonance control has a range o-f 16 values 
(0-15) which regulate how much resonance will be present on the output 
signal (0 = no resonance* 15 = maximum resonance). 

The resonance control register is in bits 4-7 of location $D0i7 
(54296). Bits 0-3 control which voices (1-3 plus external input) will 
be routed through the filter. Bits 3-0 of $D418 controls the peak 
volume. Bits 6-4 control which filter effect is active ( bit 6 = 
high-passt bit 5 = band-pass* bit 4 = low-passt bits 6+4 = notch 
reject). 

The following routine could be used to select the filtering: 

LDA SID+24 
AND 

ORA #TYPE <16=L0W, 64=HI6H, 32=BAND, 80=NOTCH-REJ) 
STA SID+24 

The following routine might be used to set the filter frequency: 

FREQ EQU 567 ANY VALUE BETWEEN 8 AND 2047 
LDA #FREQ/8 
STA SID+22 
LDA ttFREQ&7 
STA SID+21 

The relationship between FREQ and the actual frequency of the 
filter is supposedly linear from 30h2 to 12000 hz. Experimentation 
has not born this out* however* and you are encouraged to do your own 
testing of the filter controls. 

It is possible to mix an external signal with the generated 
output signal. One of the pins on the audio output port may be used 
for mike or other instrument signal input to the 64. See the PRG for 
details. 

A machine language approach to paddle and joystick programming 
is presented in the PRG and so we will not attempt to duplicate that 
information here. 
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In±enna.ls 

The Commodore 64 comes with i6K oi ROM in which the internal 
operating programs reside. These are the programs which interpret 
BASIC programs and which control the input and output devices which 
come with the 64 and those which can be added. This block o-f memory 
is broken into two segments. The -firsts the BASIC interpreter^ 
extends ^rom $A066 TO $BFFF. The secondi called the "kernal'S extends 
from $EOdO to $FFFF. Some of the kernal programs have been documented 
by Commodore in their Programmer's Reference Guide. They deal mainly 
with input/output (I/O) processing on the 64. This text will not 
attempt io duplicate the information provided in the PRG. It is once 
again strongly recommended that you obtain a copy of that reference 
work. 

There are many other subroutines included in the 64's ROM which 
are not covered in the PRG. We will attempt to provide information on 
using the more useful of those. We will also present a list of the 
entry points of the remainder. Those which are not discussed in 
detail may be decoded with the Decoder for your inspection and 
understanding. 

Floating Point rajmbers 

As BASIC processes your arithmetic expresionst it uses a 
variety of machine language subroutines to do addition, subtraction* 
exponentiation* trig functions* etc. These subroutines are available 
to the machine language program for accomplishing the same functions. 
They are all fairly similiar in the conventions of their use* i.e. the 
means of passing parameters* getting the results* etc. 

Numbers in BASIC may be expressed as either integers or as 
"floating point" numbers. Integers have no fractional component. 
They are sixteen bit signed numbers which may have the range of 
32767 to 32768. Negative numbers are expressed in two's complement 
notation as discussed m chapter four. 

BASIC does all its computations in floating point mode. 
Floating point numbers have fractional components. They are composed 
of three portions* the exponent* the mantissa and the sign. The 
exponent occupies one byte and its binary value is 128 greater than 
the exponent being expressed. The value of the expressed exponent is 
the number of bits which the mantissa needs to be shifted. Since the 
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exponent expression is stored in "excess 128" » the range of actual 
exponents is -128 to 127 (stored as to 255). Negative exponents 
mean the mantissa (as stored) needs to be shifted to the right and 
positive exponents means the mantissa needs to be shifted to the left. 

The mantissa is a four byte binary value. It is the shifted 
value of the number to be expressed. This is like scientific notation 
as used in physics and chemistry. The decimal system of scientific 
notation would express the number 12876548.765 as 1.2876548765 « 10 
raised to the 7th power. In BASIC you would see this number printed 
as 1.2876548765 207. A decimal exponent of 7 in scientific notation 
means the decimal point needs to be shifted 7 places to the right. Or 
that the mantissa needs to be multiplied by 16 raised to the seventh 
power. 

It works the same way with floating point numbers except the 
mantissa is in binary and it needs to be multiplied by 2 raised to the 
power of the exponent. Multiplying a binary number by two is the same 
as shifting it one bit position. e.g. 6 = 0000 0110 and 12 = 0000 
1100. 

CBM BASIC always normalizes the mantissa before saving it in 
the floating point format. This means that it shifts it so the 
leftmost bit is always a one bit. The number 6 (binary value = 0000 
0110) would be shifted so that the normalized mantissa would be 1100 
0000. What goes into the exponent field is 128 plus the number of 
significant bit positions in the original number. 0000 0110 has three 
significant bit positions^ so the exponent would be 131. 

A few examples will be helpful. The binary representation of 
the floating point storage of the number 6 is: 

leee eon nee ooee eeoe 0000 0000 0000 0000 0000 

131 192 

$83 $C8 $00 $00 $00 

exponent mant issa 



The exponent of 131 represents an actual exponent of 3 (131 - 
128). You may consider the mantissa as a fraction with the radix 
point (decimal point or> rather» binary point) just to its left. The 
amount it must be shifted to get back to its actual value is three 
bit positions. In other words, the radix point must be shifted from 
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the left o-f the binary number three places to the right. 
Other examples: 



Tho niimKon 1 ^flflAfi 
iiitr iiuiiiutrl i Wvvif 


0001) 












1000 0001 1000 0000 


0000 0000 


0000 


0000 


0000 


0000 




129 128 

















«81 $80 


$00 




$00 




$00 




exponent 


mant i ssa 










The number 2 <0000 


0010) 













1000 0010 1000 0000 


0000 0000 


0000 


0000 


0000 


0000 


r> 


1 ?9 1 j>fi 

X £.7 I 4CO 







D 




a 

V 




$82 $80 


$00 




$00 




$00 


n 


exponent 


mant 1 ssa 








n 


The number 3 <0000 


0011) 












1000 0010 1100 0000 


0000 0000 


0000 


0000 


0000 


0000 




129 192 















n 


$82 $C0 


$00 




$00 




$00 





exponent 


mant t ssa 










The number 65 (010( 


3 0001) 













1000 0111 1000 0010 


0000 0000 


0000 


0000 


0000 


0000 




135 130 


















$87 $82 


$00 




$00 




$00 


exponen t 


mant 1 ssa 
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The number 15 (8808 1111) 



1888 8188 1111 8888 8888 8888 8888 8888 
132 248 8 8 

$84 $F8 $88 $88 



8888 

8 
$88 



exponent 



man t i ssa 



The sign of the number is carried in the high-order bit of the 
byte following the mantissa. If the sign bit is on> the number is 
negative. If off it is positive. 

There are two floating point accumulators maintained by BASIC» 
FACi and FAC2. FACl is located at $61-$66 <97-ie3) and FAC2 is at 
$69-$6E (185-111). These two accumulators are used for all 
mathematical operations. Following the FACs> at $6F (111)> is a sign 
comparison flag. The high-order bit> if on* signifies the two FAC's 
are of differing signs. 

Arithmetic rwtines 



The following routines perform mathematical operations using 
FAClt FAC2f and values stored in other memory locations. Each routine 
may be executed by a JSR instruction to the indicated entry point. 
References to memory locations are frequently communicated to various 
routines by an address contained in the A-reg (LSB) and the Y-reg 
(MSB). We will refer to this format as format-i. 

Most of the following routines use the A-reg> X-reg and Y-reg 
for communication. It is an interesting fact that when a SYS is done 
from BASIC# these three registers are loaded from memory locations 
788» 781 and 782 respectively. Additionally! the Processor Status 
register is passed in 783. All of the registers are stored bacK in 
these same locations upon returning to BASIC so it is therefore 
possible to easily pass information back and forth between BASIC and 
machine language programs. You can call the following routines and 
those in the Kernal from BASIC by SYSing to them after setting up the 
three register storage bytes. 
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InttgertoFACl - $8391(45969) 

A two-byte integer value in fopmat-i is converted to a floating 
point number stored in FACi. 

FACl to Integer $B1AA (45482) 

The FACl is converted to a two-byte integer which is saved into 
locations $64,$65 (160,161). The FACl is destroyed. 

Mtmory to FACl $BBA2 (48034) 

A five-byte floating point number anywhere in memory is loaded 
into FACl. The address of the starting memory location is in format- 
1. The sign flag of FACl is set on if the high-order bit of the 
mantissa is a oner else it is set of f. The exponent is returned in 
the A-reg. 

ASai to FACl $B7B5 (47029) 

An ASCII string is converted to floating point format and saved 
in the FACl. The string may be anywhere in memory and the address of 
the starting location must be pointed to by the utility string pointer 
at $22t$23 (34,35). The length of the string must be loaded into the 
A-reg. 

FACl to ASCII $BDDD (48605) 

The ASCII representation of the value in FACl will be saved 
starting at $0100 (256) and continuing until a $00 is encountered. 

Memory to FAC2 $BA8C (47756) 

Same as above except using FAC2 and the sign comparison flag is 
set. The exponent of FACl is returned in the A-reg. 

FACl to Memory $BBD7 (48087) 

The FACl is stored into any five byte memory location. The MSB 
of the address of the start of the memory location is passed in the X- 
reg. The LSB is in the Y-reg. The high-order bit of the mantissa 
field is forced to the FACi sign flag. 

FAC2 to FACl $BBFC (48124) 

A simple move is performed from FAC2 to FACl. FAC2 is not 
affected. 



o 

n 
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FACitoFAC2 IBCeF (48143) 

A simple move is performed from FACl to FAC2. FACl is not 
affected. 

Logical AND of FACl and FAC2 $AFB9 (4M33) 

FACl and FAC2 are logically ANDed together* the result ending 
up in FACl 

Logical OR of FACl and FAC2 $AFB6 (45639) 

FACl and FAC2 are logically ORed together* the result ending up 
in FACl 

FACl s FACl - FAC2 $B853 (47187) 

FAC2 is subtracted from FACl » the result replacing FACl. FAC2 
is not affected. 

FACl ° FACl ^ FAC2 $^6A (47218) 

FACl is replaced by the sum of FACl and FAC2. It is necessary 
to set the sign compare flag prior to calling this routine. This is 
done by SORing locations $66 and $6E (182 and 118) and storing the 
result in $6F. It is also necessary to load the A-reg with the value 
found in $61 (97). Note that both of these functions are done by the 
Mem to FAC2 routine. 

FACl = FACl « FAC2 $BA38 (47664) 

FACl is replaced by the product of FACl AND FAC2. The same 
notes apply as for the above routine. An alternate entry point for 
this routine is $BA28 (47656). This entry point will execute the 
memory to FAC2 routine before doing the multiplication. 

FACl » LOG ( FACl ) $B9BA (47954) 

FACl is replaced by the LOG of FACl. 

FACl s FAC2 / FACl $BB12 (47898) 

FACl is replaced by the qoutient of FAC2 and FACl. The same 
notes apply as for addition. However by JSRing to $BB8F (47887) 
instead* the loading of the FAC2 from memory will be accomplished 
prior to doing the division. 



Iniidt Tht Commodort 64 



Ptgt 13-7 



FACl » FAC2 ^ FACl $BF7B (49613) 

FACl is replaced with FAC2 raised to the power of FACl. Same 
comments as for addition. By using the $BF78 (49016) entry point, the 
routine to load FACl from memory may be executed prior to the 
exponentiation routine. The Memory to FACl routine does not properly 
set the sign compare flag however. Also note that when using these 
alternate entry points, the same setup of the A-reg and Y-reg must be 
performed as per Mem-to-F AC routines before calling the desired 
arithmetic routine. 

FACl s FACl / le $BAFB (47870) 

FACl is replaced by FACl / 10. 

Compare FACl and Memory $BCSB (48219) 

The A-reg is set depending on the result of the compare between 
FACl and some floating point number in a specified memory location. 
If they are equal, the result is 0; if they are not equal the result 
is $FF (255). The address of the start of the memory location is in 
format-1. 

FACl ° ABS ( FACl ) $BC58 (48216) 

The FACl is replaced by the absolute value of FACl. 

FACl » INT ( FACl ) $BCCC (48332) 

The FACl is replaced by the integer portion of FACl. 

FACl s SGN ( FACl ) $BC39 (48185) 

The FACl is replaced by the value if it was a zero, by 1 if it 
was greater than zero and by -1 if it was less than zero. 

FACl » SQR ( FACl ) $BF71 (49009) 

The FACl is replaced by the square root of FACl. 

FACl » EXP'i FACl ) $BFBD (49133) 

The FACl is replaced by the value computed by raising e of 
natural logarithm to the power of FACl. 

FACl » COS ( FACl ) $B264 (57956) 

The FACl is replaced by the Cosine of FACl expressed in radians. 
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FACi ^ SIN ( FACi ) $B26B (57963) 

The FACI is replaced by the Sine of FACi expressed in radians. 

FACI » TAN ( FACi ) $B2B7 (58039) 

The FACi is replaced by the tangent of FACi expressed in radians. 

FACi » ATN ( FACi ) $B3eD (58i25) 

The FACI is replaced by the arctangent of FACI expressed in 
radians. 

Irput/Output routines 

Most of the I/O routines are presented in the PRG but there are 
two more presented here which do not appear there. 

Ir^ into BASIC buffer $A56e (42336) 

The 88 byte BASIC input buffer starting at $6200 (512) is 
filled with characters from the Keyboard. A CReturn] terminates the 
input and a $00 signifies the end of the message in the buffer. 

Output string to screen $ABiB (43806) 

The starting address of a string of ASCII characters to be 
printed on the screen is set in format-1. The string must be 
terminated by a $00. 
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Appendix A 



Mode 


1 


2 


3 


4 


5 6 


7 


8 


9 


18 


ADC 




X 


X 


X 


X 


X 


X 






AND 




X 


X 


X 


X 


X 


X 






ASL 


X 




X 


X 


X 


X 








BCC 


















X 


BCS 


















X 


BEQ 


















X 


BIT 






X 




X 










BtM 


















X 


BHE 


















X 


BPL 


















X 


BRK 
















X 




BJC 


















X 


BKJS 


















X 


CLC 
















X- 




CLD 
















X 




CLI 
















X 




CUJ 
















X 




CMP 




X 


X 


X 


X 


X 


X 






CPX 




X 


X 




X 










CPY 




X 


X 




X 










DEC 






X 


X 


X 


X 








DEX 
















X 




DEY 
















X 




EOR 




X 


X 


X 


X 


X 


X 






INC 






X 


X 


X 


X 








INX 
















X 




INY 
















X 




JMP 










X 










JSR 










X 










LDA 




X 


X 


X 


X 


X 


X 






LDX 




X 


X 




X X 




X 






LDY 




X 


X 


X 


X 


X 








LSR 


X 




X 


X 


X 


X 








NOP 


















X 



X X 
X X 
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Mode 1 2 3 4 5 6 7 8 9 10 11 12 13 





UKA X 


X 


Q 


PHA 
PHP 




O 


PLA 






PLP 

ROL X 


X 


o. 


ROR X 
RTI 


X 




RTS 






SBC X 


X 




SEC 




o 


SED 




SEI 




o 


STA 


X 




SIX 


X 




STY 


X 


o 


TAX 




TAY 




w 


TSX 
TXA 




o 


TXS 
TYA 






Modes: 





1 - Accumulator 

2 - Immediate 

3 - Zero page 

4 - Zero pagejX 

5 - Zero pagejY 

6 - Absolute 



7 - Absolute ,X 

8 - Absolute, Y 

9 - Impl led 

10 - Relative 

11 - <Indlrect,X) 

12 - (Indlrect),Y 

13 - (Indirect) 



X X 



X X 



n 

n 
n 
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n 



n 



nCPTMAI 


ucv 
nCA 


ASCII 


SCRccN 


BASIC 6582 


DECIMAL 


BINARY 


HEX 







OA 
00 




9 


end- line BRK 


8 


AAAA AAAA 

8888 8888 


88 


; 1 


1 


81 




A 


ORAdjX) 


1 


8888 8881 


61 


n 


2 


82 




B 


2 


AAAA A A 4 A 

8888 8818 


82 


3 


83 




C 




3 


8888 8811 


83 


n 




OA 

84 




f\ 

V 




4 


AAAA A4 AA 

8888 8188 


84 


e 



03 




r 
C 


ABA 7 

OrA Z 


5 


a AAA IX* m 

8888 8181 


85 


n 


6 


06 




r 

r 


AIM 7 

ASL Z 


6 


AAAA A4 « A 

8888 8118 


86 




7 


0/ 




6 




7 


AAAA A 4 4 « 

8888 8111 


87 




8 


flA 

88 




H 


PHP 


8 


AAAA J AAA 

8888 1888 


88 




A 
7 


AO 

07 




I 


ORA # 


9 


AAAA tfAAJ 

8888 1881 


89 




18 


8A 




J 


ASL A 


18 


8888 1818 


8A 


o 


11 


88 




K 




11 


8888 1811 


8B 




f 
l£ 


fir 
0L 




L 




12 


AAAA 4 4 A A 

8888 1188 


8C 


n 


13 


Af\ 

0D 


cap pet 


M 


ORA 


13 


AAAA J 4 A « 

8888 1181 


8D 




1 A 

14 


ACT 

8c 




N 


ASL 


14 


AAAA 4 4 4 n 

8888 1118 


8E 


f ) 


15 


8F 









15 


8888 1111 


6F 




\6 


18 




P 


BPL 


16 


8881 8888 


18 


n 


17 


11 


CUP down 


Q 


ORA(I),Y 


17 


8881 8881 


11 




18 


12 


pevepse 


R 




18 


8881 8818 


12 


19 


13 


cur hon^ 

will ilUIBC 


s 




19 


vwni vwij 


13 


f 1 


28 


14 


delete 


T 




28 


0881 8188 


14 




21 


15 




U 


ORAZjX 


21 


8881 8181 


15 


n 


22 


16 




y 


ASL Z,X 


22 


8881 8118 


16 


n 


23 


17 




u 




23 


8881 8111 


17 


24 


18 




X 


CLC 


24 


8881 1888 


18 


n 


25 


19 




Y 


ORA Y 


25 


8881 1881 


19 




26 


lA 




Z 




26 


8881 1018 


lA 


n 


27 


IB 




I 




27 


8681 1811 


IB 




28 


IC 




\ 




28 


8081 1188 


IC 




29 


ID 


CUP pight 


] 


ORAX 


29 


8881 1181 


ID 




38 


IE 




t 


ASL X 


38 


8881 1118 


IE 


n 


31 


IF 








31 


8881 1111 


IF 


n 



n 
n 
n 
n 
n 

n 
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O 





32 


20 


space 


space 




33 


21 


1 


I 




34 


22 


■ 


a 


I J 

w 


35 


23 


ft 


ft 




36 


24 


i 


$ 




37 


25 


y. 


y. 




38 


26 


& 


& 




39 


27 








48 


28 


( 


( 




41 


29 


) 


) 


i) 


42 


2A 








43 


28 








44 


2C 






o 


45 


2D 








46 


2c 


• 






47 


2F 


/ 


/ 




48 


38 


8 


8 


w 


49 


31 


1 


1 




58 


32 


2 


2 




51 


33 


3 


3 




52 


34 


4 


4 




53 


35 


5 


5 


U 


54 


36 


6 


6 




55 


37 


7 


7 




56 


38 


8 


8 




57 


39 


9 


9 




58 


3A 








59 


36 




5 




68 


3C 


< 


< 




61 


3D 








62 


3E 


> 


> 




63 


3F 


? 


7 
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BASIC 



6582 



DECimL 
. 


Bir«^RY 


HEX 


space 


JSR 


32 


8818 8888 


— 
28 


1 


AND<I,X) 


33 


8818 8881 


21 


a 




34 


8818 8818 


22 


ft 




35 


8818 8811 


23 


$ 


BIT 2 


36 


8818 8188 


24 


y. 


^D 2 


37 


8818 8181 


25 




ROL 2 


38 


8818 8118 


26 






39 


8818 8111 


27 


«: 


Pir 


48 


8818 1888 


28 


) 


AND ft 


41 


8818 1881 


29 


* 


ROL A 


42 


8818 1818 


2A 


♦ 




43 


8818 1811 


28 




BIT 


44 


8818 1188 


2C 




^D 


45 


8818 1181 


2D 


• 


ROL 


46 


8818 1118 


2E 


/ 




47 


8818 nil 


2F 


8 


BNI 


48 


8811 8888 


38 


1 


^D(I),Y 


49 


8811 8881 


31 


2 




58 


8811 8818 


32 


3 




51 


8811 8811 


33 


4 




52 


8811 8188 


34 


5 


AND 2,X 


53 


8811 8181 


35 


6 


ROL 2,X 


54 


8811 8118 


36 


7 




55 


8811 8111 


37 


8 


SEC 


56 


8811 1888 


38 


9 


/V<D Y 


57 


8811 1881 


39 




CLI 


58 


8811 1818 


3A 


1 




59 


8811 1811 


38 


< 




68 


8811 1188 


3C 




AND X 


61 


8811 1181 


3D 


> 


ROL X 


62 


8811 1118 


3E 






63 


8811 nil 


3F 
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BASIC 


6582 




64 


— 
48 







B 







RTI 


65 


41 


A 




A 


EOR(I,X) 


66 


42 


8 


m 


8 


67 


43 


C 


B 


C 




68 


44 


D 


B 


D 




69 


45 


E 


□ 


E 


EOR 2 


78 


46 


F 


□ 


F 


LSR Z 


71 


47 


6 


o 


6 




72 


48 


H 


□ 


H 


?m 


73 


49 


I 




I 


EOR « 


74 




J 


□ 


J 


LSR A 


75 


48 


K 


□ 


K 




76 


4C 


L 


□ 


L 


.HIP 


77 


4D 


M 




N 


EOR 


78 


4E 


N 





N 


LSR 


79 


4F 





□ 







88 


58 


P 


□ 


P 


eve 


81 


51 


Q 




Q 


EOR(I),Y 


82 


52 


R 


□ 


R 




83 


53 


S 




S 




84 


54 


T 


□ 


T 




85 


55 


U 


□ 


U 


EOR Z,X 


86 


56 


M 




V 


LSR'Z,X 


87 


57 


U 


□ 


U 




88 


58 


X 


m 


X 


CLI 


89 


59 


Y 


□ 


Y 


EOR Y 


98 


5A 


2 




Z 




91 


58 




ffl 






92 


5C 




E] 






93 


5D 




CD 




EORX 


94 


5E 




E 




LSRX 


95 


5F 




H 







n 
n 
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64 


8188 8888 


48 




65 


8188 8881 


41 


66 


8188 8818 


42 


n 


67 


8188 8811 


43 


68 


8188 8188 


44 


n 


69 


8188 8181 


45 




78 


8188 8118 


46 




71 


8188 8111 


47 




72 


8188 1888 


48 


73 


8188 1881 


49 


n 


74 


8188 1818 


4A 




75 


8188 1811 


48 


r\ 


76 


8188 1188 


4C 




77 


8188 1181 


4D 




78 


8188 1118 


4E 




79 


8188 nil 


4F 


88 


8181 8888 


58 


n 


81 


8181 8881 


51 




82 


8181 8818 


52 


n 


83 


8181 8811 


S3 




84 


8181 8188 


54 


r\ 


85 


8181 8181 


55 


O 


86 


8181 8118 


56 


87 


8181 8111 


57 


r\ 


88 


8181 1888 


58 


89 


8181 1881 


59 


n 


98 


8181 1818 


SA 




91 


8181 1811 


58 




92 


8181 1188 


5C 




93 


8181 1181 


5D 


94 


8181 1118 


5E 


n 


95 


8181 nil 


5F 



n 



n 
n 

O 
n 
n 
n 
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76 


68 




7/ 


61 


■J 


no 

70 


62 




oo 

77 


63 


n 

LJ 




OH 


□ 


Iffl 


ZC 

03 


□ 




00 


■ 


f AO 


0/ 


□ 


1 AJ 


OD 


H 


1 AC 


07 


CJ 


100 


6A 


LI 


t A7 
10/ 


00 


ro 
m 


1 AO 
100 


OL 


rn 
Ll 


1 AO 
107 


w 


rn 


lift 


oc 


en 
□J 


111 
111 


Or 


LJ 


119 


f u 


r3 
ud 


in 


71 

f J 




114 




Qd 


lie 
J13 


73 


til 


116 


74 


n 


117 


75 


c 


118 


70 




119 


11 


□ 


128 


78 


n 


121 


79 


u 


122 


7A 


□ 


123 


78 


D 


124 


7C 


a 


125 


7D 


a 


126 


7E 


B 


127 


7F 


H 
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nrre 
RTS 


96 


8118 


8888 


68 


ADCdfX) 


97 


8118 


8881 


61 




98 


8118 


8818 


62 




99 


8118 


8811 


63 




188 


8118 


8188 


64 


ADC Z 


181 


8118 


8181 


65 


Dm ? 
KLK Z 


182 


8118 


8118 


66 




183 


8118 


8111 


61 


Dl A 


184 


A1 1 A 

8118 


1888 


68 


ADC tt 


1 AC 

I8d 


A1 1 A 

8118 


1881 


69 


KCR A 


1 ay 

186 


8118 


1818 


6A 




1 a? 
187 


A 1 < A 

8118 


4 A4 4 

1811 


68 




1 ao 
18o 


Alia 

8118 


1188 


6C 


ADC 


1 aA 
189 


A 4 4 A 

8118 


1181 


6D 


KUR 


1 1 a 
118 


Alia 

8118 


4 4 4 A 

1118 


6E 




111 
111 


ai ia 
8118 


4 4 4 4 

nil 


6F 




110 
112 


ai 4 4 
0111 


AAAA 

8888 


"SA 

78 


ADCU)yY 


110 

113 


a4 4 4 

8111 


AAA 4 

8881 


71 




114 


8111 


8818 


72 




115 


8111 


8811 


73 




116 


8111 


8188 


74 


ADC Z,X 


117 


8111 


8181 


75 


ROR Z,X 


118 


8111 


8118 


76 




119 


8111 


8111 


77 


SEI 


126 


8111 


1888 


78 


ADC Y 


121 


8111 


1881 


79 




122 


8111 


1818 


7A 




123 


8111 


1811 


78 




124 


8111 


1188 


7C 


ADCX 


125 


8111 


1181 


7D 


RORX 


126 


8111 


1118 


7E 




127 


8111 


nil 


7F 



n 
n 
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OECIfWL 


HEX 


ASCII 


SCREEN BASIC 


6582 


DECIMAL 


BIfMRY 


ub/V 




128 


88 




r-0 END 






iVUli OvOv 




r> 


129 


81 




r-A FOR 


STA<I,X) 






81 


/-^ 


138 


82 




p-B NEXT 






IvOD VCiD 


85 




131 


83 




r-C DATA 




131 


1888 8811 


83 




132 


84 




r-D INPUT » STY 2 


132 


1888 8188 


84 

0"t 




133 


85 




r-E INPifT 


STA 2 


133 


18flfl filfil 


8*1 

Ov 




134 


U 




r-F DIM 


STX 2 


134 


1888 flilfl 


8A 
oo 




135 


87 




p-G READ 




135 


iQflfl aiii 

ivUv vlll 


87 


\U 


88 




p-H LET 


DEY 


136 


1888 1888 

iWW 4VVV 


88 




137 


89 




p-I GOTO 




137 


1888 1881 


89 




138 


8A 




r-J RUN 


TXA 


138 


1888 1818 

« WW i W 1 V 


8A 


n 


139 


86 




p-K IF 




139 


1888 1811 


88 




148 


8C 




p-L RESTORE STY 


148 


1888 1188 


8C 


ns 


141 


8D 




p-H 60SUB 


STA 


141 


1888 1181 


8D 




142 


8E 




p-N RETURN 


STX 


142 


1888 1118 

i UWV X 4 4 w 


8E 




143 


8F 




p-0 REM 




143 


1888 1111 


8F 




144 


98 




p-P STOP 


BCC 


144 


I8fti aofifl 


96 




145 


91 


cur up 


p-0 ON 


STA (I),Y 


145 


Iflfll flflBI 

Xvvi 00v4 


91 

71 


n 


14^ 


92 


TVS oii 


p-R WAIT 




146 


1881 8618 


92 




147 


93 




p-S LOAD 




147 


1881 aflii 

iwvl wwii 


93 

7w 


n 


148 


94 


insert 


p-T m£ 


STY 2,X 


i "TO 


IflAI flIAfl 


94 


o 


149 


95 




p-u mm 


STA 2,X 


117 




9^ 


158 


96 




p-V DEF 


STX 2,Y 


158 


1881 8118 


96 




151 


97 




p-W POKE 




151 


1881 8111 


97 


152 


98 




p-X PRINT # TYA 


152 


1881 1888 


98 


n 


153 


99 




p-Y PRINT 


STA Y 


153 


1881 1681 


99 




154 


9A 




p-Z CONT 


TXS 


154 


1881 1818 


9A 




155 


98 




p-C LIST 




155 


1881 1811 


98 




156 


9C 




p-\ CLR 




156 


1881 1188 


9C 




157 


9D 


cur le-ft 


p-3 CMD 


STA X 


157 


1881 1181 


9D 




158 . 


9E 




p-t SYS 




158 


1881 1118 


9E 




159 


9F 




p-*- OPEN 




159 


1881 nil 


9F 


n 







n 

O 
n 

n 



n 
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DECIHAL HEX ASCII SCREB4 BASIC 



168 


A6 


CLOSE 


161 


Al 


P-! 6ET 


162 


A2 


r-" NEW 


163 


A3 


r-» TAB< 


164 


A4 


p-$ TO 


165 


A5 


r-/. FN 


166 


A6 


P-& SPC< 


167 


A7 


THEN 


168 


A8 


r-< NOT 


169 


A9 


r-) STEP 


178 




r-» 4 


171 


AB 


P-* - 


172 


AC 


r-, ♦ 


173 


AD 


p— / 


174 


A£ 




175 


AF 


p-/ AND 


176 


BO 


p-8 OR 


177 


Bl 


p-1 


178 


82 


p-2 = 


179 


83 


p-3 


188 


84 


p-4 SGN 


181 


B5 


p-5 INT 


182 


86 


p-6 ABS 


183 


87 


p-7 USR 


184 


B8 


p-8 FRE 


185 


89 


p-9 POS 


186 


6A 


P-! SQR 


187 


BB 


p-5 RND 


188 


BC 


p- LOS 


189 


BD 


p-= EXP 


198 


BE 


p- COS 


191 


BF 


P-? SIN 



6582 


DECIMAL 


BINARY 
— — — — 


HEX 


LDY « 


168 


1818 8888 


A8 


LDA<I,X) 


161 


1818 8881 


Al 


LDX # 


162 


1818 8818 


A2 




163 


1818 8811 


A3 


LDY 2 


164 


1818 8188 


A4 


LOA 2 


165 


1818 8181 


A5 


LDX 2 


166 


1818 8118 


A6 




167 


1818 8111 


A7 


TAY 


168 


1818 1888 


A8 


LDA 8 


169 


1818 1881 


A9 


TAX 


178 


1818 1818 


AA 




171 


1818 1811 


AB 


LDY 


172 


1818 1188 


AC 


LOA 


173 


1818 1181 


AD 


LDX 


174 


1818 1118 


AE 




175 


1818 nil 


AF 


BCS 


176 


1811 8888 


B8 


LDA<I),Y 


177 


1811 8881 


81 




178 


1811 8818 


82 




179 


1811 8811 


83 


LDY 2,X 


188 


1811 8188 


84 


LOA 2,X 


181 


1811 8181 


85 


LDX 2,Y 


182 


1811 8118 


86 




183 


1811 8111 


87 


CLM 


184 


1811 1888 


B8 


LDA Y 


185 


1811 1881 


B9 


TSX 


186 


1811 1818 


BA 




187 


1811 1811 


BB 


LDY X 


188 


1811 1188 


BC 


LDAX 


189 


1811 1181 


80 


LDX Y 


198 


1811 1118 


BE 




191 


1811 nil 


BF 



Inside Tht Commodore 64 



DECm HEX ASCII SCREEN BASIC 



192 


C8 


TAN 


193 


CI 


ATN 


194 


C2 


PEEK 


195 


C3 


LEN 


196 


C4 


STW 


197 


C5 


m 


198 


C6 


ASC 


199 


C7 


CHR$ 


288 


C8 


LEFTI 


281 


C9 


RIGHT$ 


282 


CA 


HIOI 


283 


CB 




284 


CC 




285 


CO 




286 


CE 




287 


CF 




288 


08 




289 


01 




218 


02 




211 


03 




212 


D4 




213 


05 




214 


06 




215 


07 




216 


08 




217 


09 




218 


OA 




219 


08 




228 


OC 




221 


00 




222 


DE 




223 


OF 





PAgt 



6582 


OECimi 



Bir«^RY 



HEX 
— 




CPY » 


192 


1188 8888 


C8 


CHP <I,X) 


193 


1188 8881 


CI 




194 


1188 8818 


C2 




195 


1188 8811 


C3 


CPY Z 


196 


1188 8188 


C4 


CHP Z 


197 


1188 8181 


C5 


OEC 2 


198 


1188 8118 


C6 




199 


1188 8111 


C7 


INY 


288 


1188 1888 


C8 


CHP # 


281 


1188 1881 


C9 


OEX 


282 


1188 1818 


CA 




283 


1188 1811 


CB 


CYP 


284 


1188 1188 


CC 


CHP 


285 


1188 1181 


CO 


OEC 


286 


1188 1118 


CE 




287 


1188 nil 


CF 


BNE 


288 


1181 8888 


08 


CHP(I),Y 


289 


1181 8881 


01 




218 


1181 8818 


02 




211 


1181 8811 


03 




212 


1181 8188 


04 


CHP 2,X 


213 


1181 8181 


05 


OEC 2,X 


214 


1181 8118 


06 




215 


1181 8111 


07 


CLO 


216 


1181 1988 


08 


CHP Y 


217 


1181 1881 


09 




216 


1181 1818 


OA 




219 


1181 1811 


08 




228 


1181 1188 


OC 




221 


1181 1181 


00 


DEC X 


222 


1181 1118 


OE 




223 


1181 nil 


OF 



^ Intidt The Commcxlort 64 PageB-8 





DECimi 


HEX ASCI] 


SCREB4 BASIC 6582 


DECin^L 



BINARY 



HEX 
— 






224 


— — — 
E8 


— 

CPX « 


224 


1118 8888 


E8 




225 


El 


SBC <I,X) 


225 


1118 8881 


El 




226 


E2 




226 


1118 8818 


E2 


1 j 


227 


E3 




227 


1118 8811 


E3 




228 


E4 


CPX Z 


228 


1118 8188 


E4 




229 


E5 


SBC 2 


229 


1118 8181 


E5 


230 


E6 


INC 2 


238 


1118 8118 


E4 


u 


231 


E7 




231 


1118 8111 


E7 




232 


E8 


INX 


232 


1118 1888 


E8 




233 


E9 


SBC « 


233 


1118 1881 


E9 




234 


EA 


NOP 


234 


1118 1818 


EA 


w 


235 


EB 




235 


1118 1811 


EB 




236 


EC 


CPX 


236 


1118 1188 


EC 




237 


ED 


SBC 


237 


1118 1181 


ED 




238 


EE 


INC 


238 


1118 1118 


EE 




239 


EF 




239 


1118 1111 


EF 




248 


F8 


BEQ 


248 


1111 8888 


F8 




241 


Fl 


SBC <I),Y 


241 


1111 8881 


Fl 


w 


242 


F2 




242 


nil 8818 


F2 




243 


F3 




243 


1111 8811 


F3 




244 


F4 




244 


nil 8188 


F4 




245 


F5 


SBC 2,X 


245 


nil 8181 


F5 




246 


F6 


INC 2,X 


246 


nil 8118 


F6 




247 


F7 




247 


nil 8111 


F7 




248 


F8 


SED 


248 


nil 1888 


F8 




249 


F9 


SBC Y 


249 


nil 1881 


F9 




258 


FA 




258 


nil 1818 


FA 




251 


FB 




251 


nil 1811 


FB 




252 


FC 




252 


nil 1188 


FC 




253 


FD 


SBC X 


253 


nil 1181 


FD 




254 


FE 


INC X 


254 


nil 1118 


FE 




255 


FF 




255 


nil nil 


FF 



o 



Inside The Commodore 64 



The Commodore 64 has a -feature which allows a program in 
ROM starting at $80^0 (32768) to sieze control of the machine at 
power-up and RESET times without any further intervention 
required on the part of the operator. 

At power-up time one of the very first things the 
operating system does is check for a five character sequence 
starting at location $8004. If it finds $C3f$C2,$CD,$38,$3e it 
will automatically ^mp to the address it found at $8OOO»$80Oi. 
A second address is stored in $8002»$8603. This is the address 
of the [RESTORED key processing routine. 

To create your own cartridges you must encode the first 9 
bytes as described above. It will be necessary to burn a PROM 
(programmable read only memory) and install it on an appropriate 
card for complete auto-start capability. The Programmer's 
Reference Guide has complete definition of the card connector 
specifications. Prom programmers are available from a variety of 
sources. Check the magazine ads. 
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Pagt 



Commodore 64 Memory Ma.p 



Hex 


Decimal 


Function 


0008 







On-chip da-ta-direction register 


0001 


I 




On-chip I/O Port 


0002 


2 




Unused 


0003 


3-4 




Float->integer 


0005 


5-6 




Integer->-float 


0007 






Search char ":" or endline 


0008 


8 




Scan btwn quotes ^lag - 00 as delimeter 


0009 


9 




Column pos of last Tab 


000A 


i Kf 




Verif/ flag (0=Load/l= Verify) 


0006 


1 1 
1 i 




Basic input buffer pointer/ttsubscripts 


000C 


1 7 




DIM flag 


000D 






Variable flag - type:FF=string - e0=numeric 


000E 


1 4 




Integer flag :S0=integer - 00=floating pt 


000F 


1 S 

I ^J 




DATA scan flag/LIST quote flag/memory flag 


0010 


1 A. 




Subscript flag;FNx flag 


0011 


i T 

X f 




input / read (0=input - 64=get - i52=read 


0012 


1 A 




ATN sign flag:comparison evaluation flag 


0013 


1 Q 

1 7 




Current I/O device for prompt suppress 


0014 


90- 


•9 1 


Basic integer adr.(for SYS - GOTO etc) 


0016 


99 




Temporary string descriptor stack pointer 


0017 


99- 


•94 


Last temporary string vector 


6019 


25- 


■33 


Stack of descriptors for temporary strings 


8022 


34- 


•35 


Poirtter for number transfer 


0024 


36- 




Misc number pointer 


0026 


38- 


•42 


Prodct area for mult 


002B 


43- 


■44 


Pointer to start of Basic 


002D 


45- 


•46 


Pointer to end of prog.start of variables 


002F 


47- 


■48 


Pointer to end of variables start of arrays 


0031 


49- 


•50 


Pointer to end of arrays 


0033 


51- 


-52 


Pointer to bottom of strng spce (coming dwn) 


0035 


53- 


-54 


Pointer to top of active strings 


0037 


55^ 


-56 


Pointer to end of memory 


0039 


57- 


-58 


Current Basic line number 


003B 


59- 


-60 


Prev BASIC line num 


003D 


61- 


■62 


Previous BASIC statement <for CONT) 



n 

O 
O 

Inside The CommcMiore 64 Page D-2 ^ 



Hex 


Decimal 


Function 




883F 


63-64 


Line number - current DATA line 


6041 


65-66 


Pointer to current DATA item 




0643 


67-68 


Input vector 




0045 


69-70 


Current variable name 


8647 


71-72 


Current variable address 




0049 


73-74 


Variable pointer -for FOR /NEXT 




684B 


75-76 


Y save/new op save/curr op pointer 


n 

--^ 


604D 


77 


Special mask -for curr oprtrjComparison symbol 


r 1 


004E 


78-79 


Misc. work area;-function def pointer hi-lo 


0050 


80-81 


Work area;pointer to strng descrptn 


n 


0052 


82 


Length o-f above string 


0053 


83 


Constant used by garbage collect - 3 or 7 


r^ 


0054 


84-86 


Jump vector for functions 




0057 


87-96 


Misc. numerical storage area 


r\ 


0061 


97-102 


FAC#1 




0067 


103 


Series evaluation constant pointer 




0068 


104 


FAC#i high ord propogation 


r\ 


0069 


105-110 


Accumulator #2 


006F 


111 


Sign comparison - FACl vs FAC2 


r) 


0070 


112 


Low order rounding byte for Acc#i 




0071 


113-114 


Cassette buffer length /series pointer 





0073 


115-138 


Subrtn:Get Basic char;7A - 7B=pointer(CHARGOT) 




008B 


139-143 


RND storage and work area 


1 


0090 


144 


Status ST 


r) 


0091 


145 


Stop/RVS key flag 


0092 


146 


Timing constant for tape 


r\ 


0093 


147 


Load or verify flag L=0/V=i 




0094 


148 


Serial output/deferred char flag 


r\ 


BO zD 


1 AO 


Serial deferred character 




0096 


150 


Tape EOT recvd 


r^ 


0097 


151 


Register save area 


Q 


0098 


152 


# open files 


0099 


153 


Input device# - normally 


n 


009^^ 


lb4 


Output CMD device - normally 3 


009B 


155 


Tape character parity 


r\ 


009C 


156 


Cassette dipole switch 




009D 


157 


OS message flag - direct=$S0 - run=0 




009E 


158 


Cassette error pass i 





o 

n 



Intidt Tht Commodort 64 



Ptgt D-8 



Hex 


Decimal 


Function 


e09F 


159 




Cassette error pass 2 


80A6 


160- 


162 


Ji-f-fy clock (HMD 


00A3 


163 




Serial bit count 


00A4 


164 




Cycle counter "for serial I/O 


00A5 


165 




Cntdwn "for t^n^ write 


V OMO 


166 








167 




ne-9Q9 innii+ hit 5+oraae/TaDe shrtcnt 
RS-232 bit cnt in/ Tape read error 


00A8 


168 




00A? 


169 




RS-232 flag start bit ck/Tape rd bit err 


00AA 


170 




RS-232 byte buf-fer/Tape rd mode 


00AB 


171 




RS-232 parity storage/Tape chksum 


00AC 


172- 


173 


Tape start addr/tape buffer / scrolling 




174- 


175 


Tahp pnri ariHr/pnd of current oroaram 




176- 


177 


Taop timino ron^+Ant^ 

1 fll^C LXIIIXI lU bUI 19 LOll 1 V9 




178- 


•179 


Addr of t^oe buffer 


00B4 


180 




RS-232 transmitter bit cnt out 




181 




nc-ooo fran^mittpr ni-it bit to be sent 




182 




nc_232 transmitter bvte buffer 

X^W bl QlllSIIIAVVd Uy WW 1 iSI 


vvOf 


183 




Lpnnth of current file name strina 

Imm W 1 lU bl 1 W 1 VbUJI I 1i» I I V 1 AAW 1 lHklll%* ^ VI Al 11^ 


O V DO 


184 




f"iirrpnt lonical filp number 

WWl 1 Cllh AWUAUaA 1 IIUIIIUwl 




185 




Pi irr cprnnriarv addr — nr R/W COmmAnd 

wUI 1 SCwwl lUOll 7 OIUUI V^i t\/ w wwiiiiiimivrf 


O O Dpi 


186 




Curr dpvicp numbpr 

wUI 1 UCVXlaC IIUIIIWCI 


V V DD 


187- 


■188 


Addr of curr flip name strina 

j^uui Wl wUi 1 1 aac I imiib 9 VI Ai it^ 


flPIRH 

U O Dl/ 


189 




RS-232 write shift word /Receive input char 


U V DC. 


190 




ttblockQ rpmainino to re ad /write 


O O Di 


191 




Sprial word buffer 

wCi aoa WWl u wvj i 1^1 




192 




Cas5 motor interlock 

W6193 lllw VWl Al 1 VCI AWWrt 


V U L.- I 


193- 


■194 


Taoe start addr(load) 


00C3 


195- 


-196 


KERNAL setup pointer 


00C5 


197 




Matrix co-ordinates of key pressed 


00C6 


198 




#of characters in keybrd buffer 


00C7 


199 




Reverse mode flag - 0=off - 18=on 


00C8 


200 




End of line for input pointer 


00C9 


201- 


-202 


Cursor log (row - column) 


00CB 


203 




Print shifted Chars flag 


00CC 


204 




Cursor blink enabled flag - d=on - l=off 


00CD 


205 




Delay before cursor blinks 


00CE 


206 




Character under cursor 



o 



Inside The Commodort 64 P*9» O 



Hex 


Decimal 


Function 




00Cr 


'^A"7 

207 


Lupsor on/ ott uimR TidiQ 






'5AO 
20O 


input troni screBn/KByuru 




0UU1 


^0y-£l 


bCreen duur\rOw/poiniBr\5CreBn meniui // 






21 1 


tv\0Ar\ lino 

rOBition ot cursor on curr iinB 








UlUOXe fnOuB tiay \0-Ott / l-un/ 


aorsc: 


ill o 


Line leng in Tor strBBn 


n 


ooUO 




r^i tt^i^an^ ernoon lino ni imhpp 
wurrBnx surBBi i iii ib i iuiiiubi 








ACPTT wall IB nX lacf Uev nrocc 
MDwii VdlUB UT idBL nuj pi B99 


r^ 




91 X 


ik rkX incon^'c m i^cfiinHinn 
TT UT iMaBI La uu us leii lUAi 








screen iiriB iinn lauiB 


r\ 






screen row marhBr 








DLrcBn kuiur pii 






94*^ — 9dX 


rveyscdn iduiB inuirBtt 


r\ 


oor r 




Pniri'for in RQ— 7^9 rprpix/P hu44pr ^ddr 

t UXlilBI lU r\w 1 BUBXVB UUTTCI aUUI 




00 r 7 


£*t7 £U0 


Pnin+pr fn R*?— 9^7 +rAncimif tpp hu^^pr Addp 


n 


otfrb 


9c:i — Oc:^ 


r ree zero paye locd xions 




oorr 




DAoiw sXurdyB 


r> 


1 DO 




r iodxing to Abuii worK dred 


r\ 


0180 


256-31 8 


Tape error log 


1 oU 


i:D6— Dl 1 


Processor stack area 




OilOO 


Dl ii-ooo 


Basic input buf'fer 




ft oc;o 


X ft i _^ i ft 

oo 1 -61 o 


Logical tiie nuuioer tauie 




0iCOO 


y 1 i « zoo 
oil "O^V 


uevice nuiiiuer iduie 




0£6U 


621 -6oo 


beconQary auor ot n/w emu lauie 






6J1 -640 


Keyboard buffer 




o^ol 


641-642 


Start of memory 


0283 


^ j1 O ^ >l v1 

643-644 


Top of memory 


r\ 


O/LOD 


64D 


Cardial '^imami'^ XI on 

Deridi LiiTiBuuT Tidy 




0286 


646 


Active color code 





0287 


647 


Background color under cursor 




0288 


648 


Top of Screen page 




0289 


649 


Keyboard buffer max length 




028A 


650 


Repeat flag - 0=cursor only - i28=all keys 


028B 


651 


Delay before repeat occurs 


n 


028C 


652 


Delay btwn repeats 




028D 


653 


Shift flag byte 




028E 


654 


Last shift pattern 




028F 


655-656 


Indirect for keyboard table setup 
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8291 


657 




Shift mode switch - 0=enabled - i28=locKed 




0292 


658 




Auto scroll dwn •flag(0=on - 00=0^ 




0293 


659 




6551 RS232 control register image 




0294 


660 




6551 RS232 Command register image 




0295 


661- 


•662 


Non standard (bittime/2-100) 


t J 


0297 


663 




6551 RS-232 status register image 




0298 


664 




Number o-f bits to send 




0299 


665- 


-666 


Baud rate -full bit time 




029B 


667 




RS-232 end of receiver pointer 




029C 


668 




RS-232 start receive buffer 




029D 


669 




RS-232 start transmit output buf 


029E 


670 




RS-232 end of transmit buffer 




029F 


671- 


■672 


Holds IRQ during tape operation 


02A1 


673- 


•767 


Program indirects 




0300 


768- 


■769 


Indirect error routine 




0302 


770- 


•771 


Indirect warm start 


w 


0304 


772- 


•773 


Indirect tokenize BASIC 




0306 


774- 


•775 


Indirect token print 




0308 


776- 


•777 


Indirect new token 


W 


030A 


778- 


■779 


Indirect symbol evaluation 


030C 


780 




Temporary storage during SYS of A-reg 




0300 


781 




Temporary storage during SYS of X-reg 




030E 


782 




Temporary storage during SYS of Y-reg 




030F 


783 




Temporary storage during SYS of P-reg 




0314 


788- 


-789 


IRQ vector 




0316 


790- 


-791 


BRK vector 




0318 


792- 


-793 


NMI vector 


031A 


794- 


-795 


Open logical file vector (OPEN) 




031C 


796- 


-797 


Close logical file vector (CLOSE) 




031E 


798- 


-799 


Set input device vector (CHKIN) 




0320 


800- 


-801 


Set output device vector (CHKOUT) 




0322 


802- 


-803 


Reset default I/O (CLRCHN) 




0324 


804- 


-805 


Input from device (CHRIN) 




0326 


806- 


-807 


Output to device vector (CHROUT) 




0328 


808- 


-809 


Test STOP key vector (STOP) 




032A 


810- 


-811 


Get from keyboard vector (GETIN) 




032C 


812- 


-813 


Close all files vector (CLALL) 




032E 


814- 


-815 


User defined vector 




0330 


816- 


-817 


Load from device vector (LOAD) 




0332 


818 


-819 


Save to device vector (SAVE) 



o 
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0334 


820-827 


Unused 


833C 


828-1019 


Cassette buffer 


03FC 


1020-1023 


Unused 


0408 


1024-2047 


1024 byte screen memory area 


0400 


1024-2023 


25 lines by 46 columns video matrix 


07F8 


2040-2047 


Sprite data pointers 


0800 


2048-40959 


Normal user Basic area 


A000 


40960-49151 


BASIC ROM or 8K of RAM 


A000 


40960 


Keyword action addresses 


A046 


41030 


Function action addresses 


A074 


41076 


Operator action addresses 


A092 


41106 


Keyword Table 


A193 


41363 


Error messages 


A38A 


41866 


FOR - GOSUB search stack 


A3B8 


41912 


Open memory space 


A3FB 


41979 


Test stack depth 


A408 


41992 


Check available memory 


A435 


42037 


Send error message 


A474 


42100 


Print READY. 


A483 


42110 


New BASIC line processing 


A533 


42291 


BASIC line chaining 


A560 


42336 


Receive line from keyboard 


A57C 


42364 


Tokenize BASIC line 


A613 


42515 


Search for line number 


A642 


42562 


Perform NEW 


A660 


42592 


Perform CLR 


A68E 


42638 


Reset BASIC execution to start-of-program 


A69C 


42652 


Perform LIST 


A742 


42818 


Perform FOR 


A7ED 


42989 


Execute BASIC statement 


A81D 


43037 


Perform RESTORE 


A82C 


43052 


Perform STOP and END 


A857 


43095 


Perform CONT 


A871 


43121 


Perform RUN 


A883 


43139 


Perform GOSUB 


A8A0 


43168 


Perform GOTO 


A8D2 


43218 


Perform RETURN 


A8EB 


43243 


Perform DATA 



^ Intid* The Commodort 64 P*9tD-7 





ncA 


lyeuxiiicix 


ITi inr+inn 
r ui iw vAwi 1 








SLciri Tui ficA I siaitrfiieiii 




A909 


43273 


Scan 4"Qr npxt line 












Pl7 OD 


*T £ 


« el TUI III fTCirl 




H7HD 




rcrToriii \Ji\ 




ri70D 


too r i 


VJeX inXeycr TrUlIi IBaX 




MTHiJ 




PonXnnm T I7T 

ncrToriTi lq i 


w 


AA80 


43648 


Per'form PRINTS 




AAR<^ 


43654 


1 Bl TUI III 




AA9A 


43674 


Per-form PRINT 

A CI i Wl 111 1 AAAAV i 


( i 


ABIE 


43806 


Print Q+rinn ^rnm anv mpmnrv 
ii XI 1 w a 11 aI iu ti uiii ai ly iiiciiiui y 




AB3B 


43835 


Print format charActer 

I 1 Ai 1 w 1 Wl iim V Wl 1611 viib bd 




AB4D 


43853 


Ppocsss bdd input 




AB7B 


43899 


Per-form GET 


w 


A6A5 


43941 


Ppr-fnrm TMPHTtt 
iCi TUI III ivir\j 1 TT 




riDDi 




ppr-fnrm TNPTTT 

FCl TUI III iiMru 1 




rfDrT 


44QOi^ 


rruiTipT ct inpul 


w 




44000 


Paf%Xrvnm DtS*ATN 

rBrTurm nciAJJ 






44004 


inpuT error messayes 


w 


ML/ I C. 




Ppr<fnrm ME7YT 

i crTurni imBiAI 




riUf O 


444Rfi 


T*\/nQ rriatrh rKar*!/ 
1 ypc ma iLn cneLn 






4444X 


CiVaiuaXe cKprcaSlun 




^P<^R 
MCMO 


4471 9 


ri in TiuaXiny puinx 




AFF1 




C\/AliiAto witHin n^rpnthocic 
avaiuaie will mi pal ciiiiicsxs 




AFF7 


447Q1 

"T'T f 7 1 


PhprU -fnr 
Vrflleun TUI / 




^FF^ 


44794 


PhprU Xnr " 0* 


w 


AFFH 


44797 


PhprU -fnr " - " 

Wl iBLn TUI 




AF68 


44808 


^vntav prrnr 
11 van ei 1 UI 




AF14 


44820 


Search for variable name 


o • 


AFA7 


44967 


Set up FN references 


AFE6 


45030 


Perform OR 


w 


AFE9 


45033 


Perform AND 




8016 


45078 


Comparison routine 


w 


B07E 


45182 


Perform DIM 




B08B 


45195 


Locate variable 




B113 


45343 


Check for alpha ASCII 




BHD 


45341 


Create new variable 




B194 


45460 


Array pointer routine 



Inside The Commodore 64 Page 



Hex 


Decimdl 


Function 


B1A5 


45477 


32768 in ^loaiina □oin't 


BIBF 


45583 


FACl "to inteoer 

I w X VW XI i VCUBI 


BlDl 


45521 


Find or CrPAte Arrav 


B34C 


45968 


CoiTiDute subscriot size 


B37D 


45949 


Perform FRE 


B391 


45969 


Inteaer to FACi 


B39E 


45982 


Perform POS 

A Kl 1 WI III A 


B3A6 


45990 


Check for DIRECT mode 


B3B3 


46803 


Perform DEF 

A 1 1 WI III JLtthM A 


B3E1 


46849 


Check FN syntax 


B3F4 


46068 


Evaluate FN 


B465 


46181 


Perform STR$ 


B475 


46197 


Calculate string vector 


B487 


46215 


Set up string 


B4F4 


46324 


Build string vector 


B526 


46374 


Collect garbage (make room for string) 


B5BD 


46525 


Check string collection eligibility 


B666 


46598 


Collect string 


B63D 


46653 


Concatenate string 


B67A 


46714 


Build string to memory 


B6A3 


46755 


Discard unwanted string 


B6DB 


46811 


Clean the descriptor stack 


B4EC 


46828 


Perform CHR$ 

A CI 1 WI III ^^AAAt^ 


B78e 


46848 


Perform LEFT$ 


B72C 


46892 


Perform RIGHT$ 


B737 


46903 


Pprform MIDt 

1 CI 1 WI III ilXXiT^' 


B761 


46945 


Pull strina oarameters from stack 

A w*A 9 vi Jkw lu wm miiw wwi 9 11 will «9 voiwr\ 


B77C 


46972 


Perform LEN 

A l»i 1 WI III k»U k% 


B782 


46978 


Evi^ s+rinn mod@ 

W A X V 9 LI XI Iw IIIWUC 


B78B 


46987 


Perform ASC 


B79B 


47003 


Input byte parameter 


B7AD 


47021 


Perform VAL 


B7EB 


47083 


Get POKE /WAIT parameters 


B7F7 


47095 


FACI to integer 


B80D 


47117 


Perform PEEK 


B824 


47140 


Perform POKE 


B82D 


47149 


Perform WAIT 


B849 


47177 


Add e.5 to FACI 
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B856 


47184 


Per-form subtraction 




B86A 


47218 


Per-form addition 




B947 


47431 


Complement FACl 


( 1 

w 


B97E 


47486 


Overflow 




B983 


47491 


Single byte multiply 


w 


B9BC 


47548 


Floating point constants 




B9EA 


47594 


Perform LOG 




BA28 


47656 


Multiply FACi * memory 




BA30 


47664 


Multiply FAC2 * FACi 




BA59 


47705 


Multiply a bit 


V 


BA8C 


47756 


Memory to FAC2 




BAB7 


47799 


Adjust FAC1/FAC2 




BAD4 


47828 


Underflow/ overflow 




BAE2 


47842 


Multiply FACi by 10 




BAF9 


47865 


Constant 16 


u 


BAFE 


47870 


Divide by 10 




BB07 


47879 


Divide FAC2 / memory 




BB0F 


47887 


Divide memory / FACI 


BB12 


47890 


Divide FAC2 / FACI 




BBA2 


48034 


Memory to FACI 




BBD7 


48087 


FACi to memory 




BBFC 


48124 


FAC2 to FACI 




BceF 


48143 


FACI to FAC2 




BCl B 


481 55 


Round off FACI 


Lj 


BC2B 


48171 


Get sign 




BC39 


48185 


Pppform SGN 

A CI 1 Wl III W W Ab 




BC58 


48216 


Perform ABS 

i Ck 1 1 Wl III ftJb/W 




BC5B 


48219 


Compare FACI to memory 


U 


BC9B 


48283 


FACi to integer 


W 


BCCC 


48332 


Perform INT 




BCF3 


48371 


ASCII to FACI 




BD7E 


48510 


Get new ASCII digit 




BDB3 


48563 


Constants 




BDDD 


48605 


FACI to ASCII 




BFll 


48913 


More constants 




BF71 


49009 


Perform SQR 


u 


BF78 


49016 


Perform exponentiation 




BFB4 


49076 


Perform negation 



Inside The Commodore 64 
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nex 
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Function 


Dror 


49087 


More constants yet 


OCCT\ 

arhu 


49133 


Per-form EXP 




49152-53247 RAM available -for machine language progs 


D806 


53248-57343 I/O & Color RAM/Char Gnratr R0M/4K RAM 


D000 


53248 


Sprite U X ros 


u\ov 1 


53249 


bprite u Y ros 




53250 


Sprite 1 A ros 




53251 


Sprite 1 Y ros 




53252 


bprite £ A ros 




53253 


Sprite 2 Y ros 




53254 


sprite d A ros 


D007 


53255 


Sprite 3 Y ros 


D00O 


53256 


Sprite 4 A ros 




tDo2D/ 


sprite *f I ros 




5325o 


sprite D A ros 


D00D 


53259 


bprite D Y ros 




Do2olj 


sprite A ros 




coo ^ i 

53261 


sprite Y ros 


U00C 


coo y o 

53262 


Sprite 7 A ros 


D00r 


coo^ o 
53263 


sprite / Y ros 


D010 




sprites V f ros vmsu ot a cooruii 


r^o i i 
Uvll 


coo z c 


viL Lontroi negister 


PkO 1 o 
L/l3 1 ^ 




rTceLU/ wi lie r\ai9Lci vaxuc tui wuiiipai c x r\ wl 


D0 1 3 


53267 


Light-Pen Latch X Pos 


D01 4 


53268 


Light-Pen Latch Y Pos 


no 1 


53269 


Sprite Display Enable :l=E)nable 




53270 


VIC Control Register 




53271 


Sprites 0-7 Expand 2X Vertical (Y) 


DP1 1 P 


53272 


VIC Memory Control Register 


D019 


53273 


VIC Interrupt Flag Reg.(Bit=i: IRQ Occurred) 


D81A 


53274 


IRQ Mask Reg.l^Interrupt Enabled 


D01B 


53275 


Sprite to Bkgrnd Display Priority: 1= Sprite 


D01C 


53276 


Sprites 0-7 Multi-Color Mode Select 


D01D 


53277 


Sprites 0-7 Expand 2X Horizontal 


081E 


53278 


Sprite to Sprite Collision Detect 


D01F 


53279 


Sprite to Background Collision Detect 


D026 


53280 


Border Color 


D021 


53281 


Background Color 
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D022 


53282 


Background Color i 




D023 


53283 


Background Color 2 




D024 


53284 


Background Color 3 




D825 


53285 


Sprite Multi-Color Register 




D026 


53286 


Sprite Multi-Color Register 1 




D027 


53287 


Sprite Color 




D028 


53288 


Sprite i Color 




D029 


53289 


Sprite 2 Color 




D02A 


53290 


Sprite 3 Color 




D02B 


53291 


Sprite 4 Color 


( } 


D02C 


53292 


Sprite 5 Color 




D02D 


53293 


Sprite 6 Color 




D02E 


53294 


Sprite 7 Color 




D400 


54272 


Voice 1: Frequency Control-Low-Byte 


u 


D401 


54273 


Voice 1: Frequency Control-High-Byte 




D402 


54274 


Voice l:Pulse Wave-form Width-Low-Byte 




D403 


54275 


Unused 


w 


D404 


54276 


Voice l:Ctrl Reg. Random Noise l=On 


D405 


54277 


Envelope Gnrtr 1: Attack/Decay Cycle Control 




D406 


54278 


Envelope Gnrtr i:Sust/rel Cycle Control 




D407 


54279 


Voice 2: Frequency Control-Low Byte 


W 


D408 


54280 


Voice 2: Frequency Control-High-Byte 




D409 


54281 


Voice 2: Pulse Waveform Width-Low-Byte 




D40A 


54282 


Unused 


Lj 


D40B 


54283 


Voice 2: Control Register 




D40C 


54284 


Envelope Gnrtr 2: Attack/Decay Cycle Control 




D40D 


54285 


Envelope Gnrtr 2:Sust/Rel Cycle Control 




D40E 


54286 


Voice 3: Frequency Control-Low-Byte 




D40F 


542S7 


Voice 3- Frequency Control-High— Bvte 




D410 


54288 


Voice 3: Pulse Wave-form Width-Low-Byte 




D411 


54289 


Unused 




D412 


54290 


Voice 3:Ctrl Reg Random Noise: l=On 




D4i3 


54291 


Envelope Gnrtr 3:Attack/Decay Cycle Ctrl 




D414 


54292 


Envelope Gnrtr 3:Su5t/Rel Cycle Control 


w 


D415 


54293 


Filter Cutoff Freq Low-Nybble (Bits 2-0) 


D416 


54294 


Filter Cutoff Freq High-Byte 




D417 


54295 


Filter Resonance Ctrl/ Input Control 




D418 


54296 


Select Filter Mode and Volume 



Inside The Commodore 6A 
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D419 


54297 


Analog /Digital Cvtr:Game Paddle 1 (0-255) 


D41A 


54298 


Analog/Digital Cvtr:Game Paddle 2 (0-255) 


D41B 


54299 


Oscillator 3 Random Number Generator 


D41C 


54230 


Envelope (Generator 3 Output 


DC80 


56320 


Data Port A (Kybdi Joy,Paddles>Light-Pen) 


DC01 


56321 


Data Port B (Kybd^ JoytPaddlestGame Port i 


DC02 


56322 


Data Direction Register-Port A (56320) 


DC03 


56323 


Data Direction Register-Port B (56321) 


DC04 


56324 


Timer A: Low-Byte 


DC05 


56325 


Timer A: High-Byte 


DC06 


56326 


Timer B: Low-Byte 


DC07 


56327 


Timer B: High-Byte 


DC08 


56328 


Time-of-Day Clock: 1/10 Seconds 


DC09 


56329 


Time-of-Day Clock: Seconds 


DC0A 


56330 


Time-of-Day Clock: Minutes 


DC0B 


56331 


Time-of-Day Clock: Hours + AM/PM Flag (Bit 7) 


DCOC 


56332 


Synchronous Serial 1/0 Data Buffer 


DC0D 


56333 


CIA Intrpt Ctrl Reg (Read IRQs/ Write Mask) 


DCOE 


56334 


CIA Control Register A 


DCCF 


56335 


CIA Ctrl Reg B 1= alarm > 0=Clock 


DD00 


56576 


Data Port A (Serial Bus»RS-232»Mem Ctrl) 


DD01 


56577 


Data Port B (User Port,RS-232) 


DD02 


56578 


Data Direction Register-Port A 


DD03 


56579 


Data Direction Register-Port B 


DD04 


56580 


Timer A: Low-Byte 


DD05 


56581 


Timer A: High-Byte 


DD06 


56582 


Timer B: Low-Byte | 


DD07 


56583 


Timer B: High-Byte 


DD08 


56584 


Time-of-Day Clock: i/ie Seconds 


DD09 


56585 


Time-of-Day Clock: Seconds 


OD0A 


56586 


Time-of-day Clock: Minutes 


DD0B 


56587 


Time-of-Day Clock: Hours + AM/PM Flag (Bit 7) 


DD0C 


56588 


Synchronous Serial 1/0 Data Buffer 


DD0C 


56589 


CIA Intrp Ctrl Reg (Read NMIs/Write Mask) 


DD0E 


56590 


CIA Ctrl Reg.A TOD Clock Freq i=50H2,0=60Hz 


DD0F 


56591 


CIA Ctrl Reg B l=Alarm,0=Clock 


E000 


57344-65535 


KERNAL ROM 


E043 


57411 


Series evaluation 
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E08D 


574 


RND constanis 




E997 


57495 


Perform RND 


1 ) 


E264 


57956 


Perform COS 




E26B 


57963 


Perform SIN 




E2B7 


58039 


Perform TAN 




E2E0 


58080 


Constants for trig functions 




E30D 


58125 


Perform ATN 




E33E 


58174 


Constants for ATN 




E394 


58260 


Initialize RAM vectors 


w 


E3A2 


58274 


CHRGET for zero page 




E3BF 


58303 


Initialize BASIC 




E45F 


58463 


Messages 




E4AD 


58541 


Program patch area 




E505 


58629 


Set screen limits 




E50A 


58634 


Track cursor location 




E518 


58648 


Initialize I/O 


I i 
W 


E531 


58673 


Normalize screen 




E544 


58692 


Clear screen 




E566 


58726 


Home cursor 




E56C 


58732 


Set screen pointers 




E5A0 


58784 


Set I/O defaults 




E5A8 


58792 


Set vie chip defaults 




E5B4 


58894 


Input from keyboard 


w 


E632 


58930 


Input from screen 




5901 2 


Quote mark test 




C.O 7 1 


59025 


Set uo screen Drint 






59062 


Advance cursor 


U 


E6F7 


59127 


Retreat cursor 




E701 


59137 


Back into previous line 




E716 


59159 


Output to screen 




E87C 


59516 


Go to next line 




E891 


59537 


Do 'RETURN' 




£8^1 


59553 


Check line decrement 




E863 


59571 


Check line increment 




E8CB 


59595 


Set colour code 




E8DA 


59610 


Colour code table 


w 


E8E2 


59618 


Code conversion 


w 


E8E7 


59624 


Scroll screen 



n 

O 
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E965 


59749 


Ooen ^DAC& on screen 


o 


E9C8 


59848 


Move screen line 


E9E8 


59872 


Synch colour transfer 


n 


E9F0 


59888 


Spf «;+ar+— o^— line 




E9FF 


59903 


Clear screen line 




EA13 


59923 


Print to screen 


O 


EAIC 


59932 


Store on screen 


EA24 


59940 


Svnch colour to chAr 


o 


EA31 


59953 


Interrupt (IRQ) 


EA87 


60039 


ChecK keyboard 


n 


EB59 


60249 


Set tej<t mode 


n 


EB79 


60281 


Keyboard vectors 


EB91 


60305 


Keyboard maps 


O 


EC44 


60484 


Gr aohics/text control 


EC4F 


60495 


Set oraohics mode 




ED09 


60681 


Send 'talk' 




ED0C 


60684 


Send 'listen' 


n 


EDI 1 


60689 


Send control char 




ED36 


60726 


Send to serial bus 

wCi lU kw SCI ASIA |JU9 


EDB0 


60848 


Timeout on serial 

A JklllteWWV Wl 1 9d 


■ o 


EDB9 


60857 


Send listen SA 

wCI lU XIS LCI 1 


EDBE 


60862 


Clear ATM 

wlC fill li I 1« 


o 


EDC7 


60871 


Send talk SA 


EDDD 


60893 


Send serial deferred 


o 


EDEF 


6091 1 


Send 'untalk' 

WK^ 1 IW Wl 1 wojirv 


EDFE 


60926 


Send 'unlisten' 


o 


EE13 


60947 


Receive -from serial bus 

ivCWCAVC 11 Will 9C> 1 AO* WW«7 


o 


EE85 


61061 


Clock line on 


EE8E 


61870 


Clock line of-f 


n 


EEB3 


61107 


Delay 1 ms 


EEBB 


61115 


RS232 send (NMD 


o 


EF06 


61190 


New RS232 byte send 


O 


EF2E 


61230 


Error or quit 


EF4A 


61258 


Compute bit count 


n 


EF59 


61273 


RS232 receive (NMD 


EF7^E 


61310 


Setup to receive 





EFC5 


61381 


Receive parity error 




EFCA 


61386 


Receive overrun error 


O 



O 
O 
O 
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EFCD 


61389 


lACwCxvc? ui can ci i ui 




EFD9 


61392 


Rpcpivp ^PAmp prpor 




EFEl 


61 409 


File to RS232 




F017 


61463 


Send to RS232 bu-f-fer 




F04D 


61517 


Input from RS232 bu-f-fer 


F086 


61574 


Get -from PS232 bu-f-fer 

WCb 11 Will 11WteW«» UUI Id 


i J 


F0A4 


61604 


Check serial bus idle 




F06D 


61629 


Messaaes 




F12B 


61739 


Print i-f direct 




F13E 


61758 


Get.. 




F14E 


61774 


-.-from RS232 

■ ■11 will AtWteWJto 




F157 


61783 


Input 


Fl?? 


61849 


Get..tape /5erial/RS232 


t J 

w 


FICB 


61899 


Output.. 




FIDD 


61917 


..to tane 




F20E 


61966 


Set input device 


U 


F250 


62032 


Set output device 


r £ 7 i 


0£v 7 / 


Close 




r ooi 




TTinH -filo 


F^^l F 
I o X r 


O w 7 




L J 


F32F 


62255 


Abort all "files 




F'5'5'^ 
r ooo 










O ^ U> 


Dn flip onpnino 




F3D5 


62421 


Send SA 








w 


F49F 


62622 


Load ornorafn 

LaWBU ^1 wUl aiil 


F*nAF 


62895 


'SEARCHING' 


( 1 


F*SRP 
r \JDO 


7 O t 


It XI 1 V TXXC 1 ICLltlC 




F5D2 


62930 


'LOADING/VERIFYING' 




F5DD 


62941 


Save program 




F68F 


63119 


'SAVING' 




F69B 


63131 


Bump dock 




F6DD 


63197 


Get time 




F6E4 


63204 


Set time 


u 


F6ED 


63227 


Action stop key 




F6FB 


63227 


File Error Messages 




F72C 


63276 


Find any tape header 


( 1 


F76A 


63338 


Write tape header 
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F7D0 


63440 


Get bu-f-fer address 


F7D7 


63447 


Set buf-fer start - end pointers 


F7EA 


63466 


Find specific header 


F80D 


6350 1 


Bump tape pointer 


F817 


63511 


'PRESS PLAY' 


F82E 


63534 


Check cassette status 


F838 


63544 


'PRESS RECORD' 


F841 


63553 


Initiate tape read 


F864 


63588 


Initiate tape write 


F875 


63605 


Common tape read/write 


F8D0 


63696 


Check tape stop 


F8E2 


63714 


Set timing 


F92C: 


63788 


Read bits (IRQ) 


FA60 


64096 


Store characters 


FD8E 


64398 


Reset pointer 


FB97 


64407 


New tape character setup 


FBA6 


64422 


Toggle tape 


FBC8 


64456 


Data write 


FBCD 


64461 


Tape write (IRQ) 


Fi::57 


64599 


Leader write (IRQ) 


Fl:93 


64659 


Restore vectors 


FCBS 


64696 


Set vector 


FCCA 


64714 


Kill motor 


FCDl 


64721 


Check read/write pointer 


FCDB 


64731 


Bump read/ write pointer 


FCE2 


64738 


Powerup entry 


FD02 


64770 


Check A-rom 


FD13 


64787 


Set kernal 


FD52 


64850 


Initialize system constants 


FD9B 


64923 


IRQ vectors 


FDA2 


64930 


Initialize I/O regs 


FDF9 


65017 


Save data name 


FE00 


65024 


Save -file details 


FE07 


65031 


Get status 


FE18 


65048 


Flag ST 


FE21 


65057 


Set timeout 


FE25 


65061 


Read/set top memory 


FE34 


65076 


Read /set bottom o-f memory 
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Hex 


Decimal 


Function 


FE43 


65091 


NMI interrupt entry 


FE66 


65126 


RESET/STOP warm start 


FEBC 


65212 


Restore & exit 


FEC2 


65218 


RS232 timing table 


FF48 


65352 


Main IRQ entry 


FF81 


65409 


Jumbo ^mp table 


FFFA 


65530 


Hardware vectors 
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8a.mple Bi-t— M aipped plo-t-ting 

The following programs are an example of a machine language 
subroutine> callable by either BASIC or machine language^ and a BASIC 
program which uses the routine. The machine language program is 
designed to turn on individual pixels based on a x and y bit-position 
passed from the calling routine. The routine assumes that the x 
coordinate of the point to be plotted is stored in 253#254. Location 
253 must contain the high-order bit of the number and 254 the low- 
order eight bits. The x value may range from to 319. The y- 
coordinate must be stored in location 255. The y value may range from 
to 199. The upper left corner of the screen is considered bit 
position e»6 and the lower right is position 319499. The carry bit 
is used as a mode switch. It is passed to the ML program from BASIC 
by setting the low-order bit of location 783. This is the location of 
the processor status register when communicating to machine language 
programs via a SYS. If the carry bit is set the ML program will set 
the specified bit on the screen to the foreground color. If clear* 
the color of the bit will be set to the background color. The 
BASIC program which calls the plot routine must first call the 
initialization routine which will set the screen location* clear the 
screen and the color memory. This simple BASIC program plots a 
sinusoidal pattern. 
The BASIC program: 

le SYS 49323 

20 FOR X = e TO leee STEP.e5:Y = lee + 4e * sin (X) 

30 XP = X * 30: POKE 254,XP AND 255: POKE 253, XP/256 
40 POKE 255,Y: POKE 783*1: SYS 49231: NEXT 



The machine language program: 
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LWADR 

6 HIADR 

7 CURHX 

8 CURLX 
CURY 

TEMP 



PLOT SUBROUTINES 
BY TOM COURT 

EQU 251 
EQU 252 
EQU 253 
EQU 254 
EQU 255 
EQU 2 



9 
1@ 

1 1 CHARMEM EQU ^E000 

12 SCREEN EQU *C400 

13 IRQCTRL EQU 56334 

14 ROMSWCH EQU 1 

15 BANK EQU 56576 

16 BITMODE EQU 53265 

17 SCRNPOS EQU 53272 
18 
19 
20 
21 
22 
23 
24 
25 
26 



ADDRESS POINTER 

X COORDINATE OF PLOT 

RANGE < 0-31 9) 
Y COORDINATE (0-199) 

BIT MAP OF SCREEN 



28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 



* STRAD ROUTINE * 

CON'v^ERT X,Y COORD OF PLOT TO 

ADDRESS OF BYTE TO MODIFY IN 
BIT-MAPPED CHAR MEMORY 

X-COORD MUST BE STORED IN CURX 
< 9-BIT *.;ALUE GOES IN TWO BYTES) 

Y-COORD MUST BE IN CURY 

ON RETURN X-RE6 CONTAINS 0-7 
<BYTE WITHIN 8-BYTE BLOCK) 

Y-REG CONTAINS BIT POSITION 
WITHIN THE BYTE TO MODIFY 



STRADR EQU *C000 
LDA *»0 
STA ^TEMP 
STA ^HIADR 
LDA ^CURY 



n 
n 
n 
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n 

41 AND #*F8 Y=8*INT<Y/8> 

42 ; 

43 ; TO MULT BY 40 : ^ 

44 5 FIRST MIULT BY 32 <5-BlT SHIFT LEFT) 

45 ; THEN MULT IT BY 8 < 3-BIT LEFT) O 

46 ; THEN ADD THE TWO TOGETHER 

47 5 n 

48 ASL A 

49 ROL <-HIADR ^ 

50 ASL A ^ 

51 ROL ^HIADR 

52 ASL A r) 

53 ROL <-HIADR 

54 ASL A n 

55 ROL <-HIADR 

56 ASL A ^ 

57 ROL <-HIADR ^ 

58 STA 4-LUIADR 

59 LDA ^CURY O 

60 AND #*F8 

61 ASL A ^ 

62 ROL ^TEMP 

63 ASL A ^ 

64 ROL 4-TEMP ^ 

65 ASL A 

66 ROL ♦•TEMP n 

67 CLC 

68 ADC ♦-LWADR O 

69 STA <-LWADR 

70 LDA *-TEMP ^ 

71 ADC ^HIADR ^ 

72 STA ^HIADR 

73 LDA ♦-CURLX n 

74 AND tt*F8 X=8*INT<X/8) 

75 5 n 

76 5POSITION=40*<8*INT<Y/8)*8+INT<X/8> ) 

77 5 ^ 

78 CLC ^ 

79 ADC <-LUIADR 

80 STA ^LWADR n 

<^ 

n 
n 
n 
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81 


LDA 


^•CURHX 




82 


ADC 


<-HIADR 




83 








84 


; ADDR = 


POSITION IN 


MAP + STRT OF MAP 


85 


; 






86 


ORA 


*I>CHARMEM 




87 


STA 


*-HIADR 




88 


LDA 


<-CURY 




89 


AND 


#7 


POS IN BLOCK = (Y AND 7) 


90 


TAY 






91 


LDA 


^■CURLX 


BIT POS = (X AND 7) 


92 


AND 


#7 




93 


TAX 






94 


RTS 




RETURN TO DOT 


95 








96 


\ DRAUJ 


ENTRY POINT 




97 








98 


; CARRY 


SET TO: 




99 


; PLOT (SET) UNPLOT 


(CLEAR) 


106 








101 


5 CURX, 


CURY MUST CONTAIN X,Y COORD 


102 








103 


DOT PHP 






104 


JSR 


STRADR 


GET BIT-MAP ADDR TO MOD 


105 


LDA 


I RQCTRL 


TURN OFF IRQ'S 


106 


AND 


#*FE 




107 


STA 


I RQCTRL 




108 


LDA 


^ROMSWCH 




109 


AND 


tt*FD 


SWITCH OUT THE ROM 


1 10 


STA 


^ROMSWCH 




1 1 1 


PLP 






112 


BCC 


UNDRAW 


TEST CARRY 


1 13 


LDA 


(LWADR) ,Y 


GET BYTE TO MOD 


1 14 


ORA 


TABL,X 


TURN ON SELECTED DOT 


115 


STA 


(LWADR) ,Y 




1 16 


JMP 


SKPUND 




1 17 


UNDRAW LDA 


TABLjX 


TURN DOT OFF 


1 18 


EOR 


#*FF 


REk^ERSE ALL BITS 


119 


AND 


(LWADR) ,Y 




120 


STA 


(LWADR) ,Y 





I 

o 
o 

n 

O 
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O 

121 SKPUND LDA <-ROMSWCH BRING BACK ROM 



122 ORA #2 ^ 

123 STA ^-ROMSWCH ^ 

124 LDA IRQCTRL ENABLE THE IRQ'S 

125 ORA #1 O 

126 STA IRQCTRL 

1 27 RTS n 

1 28 5 

129 ; COLOR SET ROUTINE O 

130 5 

131 ; SETS SCREEN COLORS 

132 ; n 

133 ; A-AREG MUST hWJE FGRND COLOR 

134 5 IN HIGH 4-BITS. Q 

135 ; BKGRND IN LOW-4 BITS. 

136 ; O 

137 COLOR LDX #250 SET COUNT ^ 

138 LOPCOL DEX 

139 STA SCREEN, X d 

140 STA SCREEN+250,X 

141 STA SCREEN+500,X n 

142 STA SCREEN+750,X 

143 BNE LOPCOL O 

144 RTS p. 

145 ; 

146 5 CLEARS ENTIRE HIRES SCREEN D 

147 ; ' " 

148 CLS LDA #0 O 

149 STA <-LWADR 

150 LDX #>CHARMEM GET STARTING PAGE O 

151 LOPOUT STX «-HIADR ^ 

152 LDY #0 

153 LOP IN DEY O 

154 STA <LWADR),Y STORE A 

155 BNE LOP IN O 

156 INX 

157 BNE LOPOUT CONTINUE TILL DONE O 

158 RTS ^ 

1 59 • 

160 ; INIT ROUTINE q 



o 
o 
o 

n 
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161 $ 

162 ; TURNS ON THE GRAPHICS MODE, 

163 ; CLEARS THE SCREEN 

164 ; SETS FOREGROUUND = WHITE 

165 5 AND BKGRND = BLACK 

166 ; 

167 LDA BANK-i-2 SET BANK PORT TO OUTPUT 

168 ORA #3 

169 STA BANK+2 • 

170 LDA BANK AND THE VIDEO BANK TO 3 

171 AND #*FC 

172 STA BANK 

173 LDA BITMODE 

174 ORA #32 

175 STA BITMODE 

176 LDA #*18 SET CHARMEM TO E000-FFFF 

177 STA SCRNPOS AND SCREEN TO *C000 

178 LDA #*10 SET COLORS 

179 JSR COLOR 

180 JMP CLS CLEAR SCREEN AND RETURN 

181 TABL BYT $8040201008040201 



Inside The Commodore 64 



Page B-7 



Sxplanaiion: 

The screen has 25 rows o-f 40 characters each. Each character 
has eight rows o-f eight dots each. The character memory is where the 
hi-res bit map of the screen resides. There are 8006 bytes of screen 
information contained there. This breaks down to 40 columns * 25 rows 
* 8 bytes per character. The first eight bytes of char mem contain 
the bit map of the upper left square of 64 dots arranged in an eight 
by eight array. There are therefore 40 * 8 or 320 bytes to map the 
first eight rows of dots. The second 320 bytes in character memory 
reference the second row of characters ( 8 rows of actual dots). 
SOf block #0 is the pattern for the upper left eight by eight block of 
dots and block #i is the block to the right of that and block #40 is 
the pattern of dots for the block below it and so forth till block 
#1000 which describes which pixels will be illuminated in the bottom 
right corner of the screen. 

The above machine language subroutine computes which block 
corresponds to any given X and Y dot coordinate. It also computes 
which byte within the eight-byte block holds the dot in question and 
which bit position within that byte to turn on or off. 

The Y-coordinate represents how far from the top of the screen 
the dot is located. If it is in the range of 0-7» the dot is in the 
first row of characters. If is is 8-15t it is in the second rowf etc. 
So to find the row Y must be divided by 8f discarding any remainder. 
Bach row of characters contains 40 blocks across the screen and each 
block contains eight bytes of data. So» for every row> the position 
within the table increases by 8 times 40 or 200. 

The address of the appropriate byte of the table to modify is 
built in the two-byte field labeled LWADR and HIADR. ST ADR is the 
routine which computes the address of the block to modify. It also 
returns with the relative byte within the block in the X-reg and the 
bit within that byte to modify in the Y-reg. The only thing 
remaining is to get the actual bit within the byte and either turn it 
on or off as indicated by the mode switch in location 0. This is done 
in the mainline of the DOT routine. 
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Appendix F — Oa.-ta. 

Bits. Binary digits. Its actually a contradiction in terms. 
Binary means it can have two possible values. Digit implies ten. 

The bit is the most basic unit of information. It is the 
foundation of all other more complex information formats. It is the 
only kind of information which may be stored in a "digital" computer. 
A bit may have the value of either one or zero. A byte is a grouping 
of eight bits. The 6510 is called an eight-bit microprocessor. This 
is because it processes and stores data eight bits at a time. It is 
more convenient for the purpose of understanding the nature of 
computer data to break the eight bits into two four bit sections* 
called nybbles. 

There are exactly sixteen unique four-bit combinations of ones 
and zeros such that no two arrangements are alike. There is a common 
shorthand notation for identifying these sixteen patterns. It goes 
like this: 



8421 


8421 


8421 


8421 


8088=8 


8188=4 


1888=8 


1188=C 


8881=1 


8181=5 


1881=9 


1181=D 


8818=2 


8118=6 


1818=A 


1118=E 


8811=3 


8111=7 


1811=8 


1111=F 



It's a convenient shorthand system because it is easy to 
remember. It simply numbers the patterns from 8 to 15* except* in 
keeping with the idea of using a one character code for each pattern* 
the numbers 18-15 are called A-F. So, pattern 12 is called "C" and iD' 
is "F"* etc. It's got another advantage too. The shorthand label 
system has an order which makes it easy to remember. If the left-most 
bit position may be considered to have the value of 8; and the next 
position* the value 4; and the next, ?; dhd the last, one: then the 
bit patterns may be converted to their labels by adding the bit values 
of the individual bit positions. For example: 1818 has a 1 in the 8 
position, a 8 in the 4 position, a 1 in the 2 position, and a 8 in the 
1 position. So its label is "A" because 8 + 2 = 18 and "A" is the 
code for 18. Likewise, 8118 is labeled "6" because it has no 8* one 
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4> one 2 and no 1. 

The le-ftmost bit position is called the "most-significant" bit 
because it has the greatest bit value. It is also called the "high- 
order" bit. Likewise* the rightmost bit is the "least significant" or 
"low-order bit". 

Note that all the odd numbers have a one in the rightmost bit 
position. All the even numbers* a zero. 

You can now see that the shorthand notation for identifying a 
four bit data field is very logical and it is not hard to convert back 
and forth between the bit patterns and the pattern code. This is 
important because as machine language programmers* we have to end up 
working a lot with bits. This is because the 6516 and all of the 
memory devices store and work with all data coded as bits. 

The addresses of where data is located within a memory device 
is likewise represented and transferred on the address bus in bits. 

Now* since data is stored and retrieved to and from the memory 
devices eight bits at a time (called a byte of data)* it takes two 
shorthand codes to describe the bit content of the data. A byte of 
data which has a bit structure of 1100 0168 would be identified as 
having the two-character code of "C4". The bit structure of the code 
for the letter "A" would be "41" because the bit pattern assigned to 
"A" in the ASCII coding scheme is 0100 0001. It's helpful to sit with 
a pencil and paper and write out bit patterns and figure out what 
their codes are. You should also start with the codes 0-F and convey, 
back to bit patterns. 

That there are 256 ways to represent eight bits is obvious 
from the fact that there are sixteen possible first characters of the 
two character code which identifies an eight-bit pattern and sixteen 
possible second characters. And 16 times 16 - 256. If we wanted a 
byte of data to represent a numeric value instead of an ASCII coded 
character* we can see that it could represent any value between and 
255. The 6510 does* in fact* sometimes treat data as if it is numeric 
instead of character data. Using the same two-character code to 
identify an 8 bit pattern* we can convert between the numeric value 
and the two-character code quite easily. For example* to convert from 
"A6" to its numeric value* we would multiply 10 times 16 ( "A" - 10 ) 
and add 6 to give 166. Likewise* to convert "4F" to numeric we would 
multiply 4 times 16 and add 15 ( "F" = 15 ) to give 79. It's easy to 
see that the maximum value of "FF" » 15 times 16* (240) plus 15 to 
give 255. Of course* the minimum would be "00" which is (0 times 16) 
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plus 0. 

• How about going the other way? H we want to create the bit 
pattern -for some number in the range of 6 - 255 1 we only have to 
divide the number by 16 to get the first character of the code 
(remember to translate 10 thru 15 to A thru F). Then the remainder of 
the division is the second character. Now to get the bit pattern we 
just look it up in the little bit pattern table. Put the first four- 
bit pattern together with the second and you have an eight bit pattern 
which represents the numeric value. Not hard at all. Lets try it 
with a few numbers. TaKe the number 169. How many times does 16 go 
into 169? Right. And how is that represented in our single character 
code? As the letter "A". The remainder from dividing 169 by 16 is 9. 
So our character-code representation of 169 is "A9" and if we go to 
the bit pattern table > we will see that the bit patterns are 1010 

leei. 

It is a valuable exercise to practice converting bit patterns 
to character-codes and from character-codes to decimal and from 
decimal to character-codes and character-codes to bit patterns. You 
will find a table of all 256 bit patterns and the corresponding 
character-codes and corresponding decimal values in Appendix B. 
You may check your success with the table. 

The character-code system for identifying the various bit 
patterns is» as you might know or have figured out» what in computer 
circles is called hexadecimal. Numbers* when represented in 
hexadecimal* are usually preceeded by a "$". $41 is the hex 
representation for the ASCII code for the letter "A". This removes 
any question as to whether the number is decimal or hexadecimal. From 
now on we will follow that convention in this book. 

There is another convention which is widely used to identify 
the individual bits in a byte. The bits are numbered 0-7 from right 
to left. The high-order bit is the 7-bit and the low-order bit is the 
e-bit. 

We discussed the way to represent the decimal numbers from 
to 255. The same general technique may be used to represent numbers 
from to 65535. Instead of two hex characters representing one byte 
of data, we need four hex characters representing sixteen bits or two 
bytes. Now the first pair of hex characters may be followed by any of 
256 pairs of hex characters ( $00 - $FF ). So the total number of 
possible combinations of four hex characters is 256 times 256 or 
65536. The address bus is sixteen bits wide. Which is why there are 
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exactly 65536 unique addresses possible. Now» it is frequently useful 
to be able to convert decimal addresses into hexadecimal. We saw how 
to do it with a single byte of two hex characters (8 bits). We 
divided the number by 16 to get the first character and the remainder 
was the second character. The process is similar for going from a 
number larger than 255. 

We divide the number by 256 to get the first half of the 
answer. This will be a number between 1 and 255. The remainder will 
be the second half of the answer. Both of these decimal numbers can 
then be converted to their hexadecimal counterparts by the dividing- 
by-i6 technique. These hex digits can be then easily converted to 
bits (binary) by looking up the table or retrieving it from our 
biological memory device. 

Let's do an example: Say we want to get the binary value ( bit 
configuration ) of the decimal number 47892. The first thing we do is 
see how many times 256 will go into 47892. The answer is 187. The 
remainder is 20. A line of BASIC code to do this computation would 
be: 

HA = INT ( NUM / 256 ): HB = NUM - HA * 256 

HA is the first half of the answer in decimal. HB is the 
second half. We still have to take 187 and 20 and break them into 
their two hex components. We do this by dividing by 16. 187 / 16 - 
11 with a remainder of 11. So the first two hex digits are $BB. 20 / 
16-1 with a remainder of 4. So the complete answer is $BBi4. The 
binary equivalent of $BB14 is 1011 1011 0001 0100. To double check 
our answer^ we go back the other direction and convert $BBi4 to 
decimal. $14 = (1 * 16) + 4 = 20. $BB = ( 11 # 16 ) + 11 = 176 + 11 
= 187. ( 187 * 256 ) + 20 = 47872 + 20 = 47892. And that's the 
number we started with. This process should be practiced. It is very 
helpful in solidifying the understanding of hex and binary and their 
relationships to decimal numbers. 
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